Someone sent you an Akua link. Install their app on your own Linux server, open it and keep control of it.
Someone sent you a link to their app, and you want to run your own copy of it on your own server.
For example, an agency built a booking app for you and wants it to run on a server your company
pays for, with your data staying there. This guide takes you from the link to the running app.
What happens to your server
You run one command on your server. It installs the Kubernetes worker software (k0s) and
connects your server to Akua, which then starts the app on it. The app and its data run on your
server, and you pay your server provider directly. The person who sent you the link can’t sign
in to your account or change your copy of the app. What runs on your server
lists everything the command installs.
Prerequisites
The link you received.
An email address to sign in to Akua. Signing in creates your Akua account if you don’t have one.
A Linux server that meets the server requirements: at least
2 CPUs and 4 GB of memory, root access over SSH, and outbound internet access. Akua tests
Ubuntu 24.04 on x86-64. Use a fresh server that runs nothing else. No server? Use an
Akua trial server instead.
Install the app
The app’s page shows two ways to run it: Your own server, which this guide follows, or
An Akua server, a free trial server that Akua prepares for you (see
Use an Akua trial server instead).
1
Open the link and sign in
Open the link and click Sign in to continue (or Sign in, if the page says Sign in to
see your invitation). Enter your email address, click
Continue with Email and follow the link in the email you receive. If the link was sent to
your email address, sign in with that one. You come back to the app’s page, which now has two
parts, Server and Settings, and an Install app button.
2
Choose your Workspace
Under Server, choose the Workspace that should own the app. A Workspace is your own
space in Akua; the app, its server and its settings belong to it. If you have no Workspace yet,
enter a Workspace name. If you have no Organization yet either, also enter an
Organization name, such as your company’s name. Click Create Workspace.
3
Add your server
Under Your own server, click Add a server. Review your server shows the group your
server joins: Akua creates it for you, named after your Workspace, in its default region.
Click Change if you want another name or region. Click Create join command.
4
Copy the join command
Connect your server shows the command in a Shell block. Click Copy command. The
command is for one server: it stops working 15 minutes after its first use, or after one hour
if it is not used. It is shown only on this page.Keep the command private: anyone who runs it can add a server to your Workspace.
5
Run the command on your server
Connect to your server over SSH and run the command exactly as shown. It starts with
curl -fsSL and downloads join.sh from Akua, then runs it with sudo sh join.sh, so it runs
as root. It first checks the command’s token, then installs the worker software and joins
your server. It prints Akua join: messages and ends with
Worker joined and started; wait for Ready in the dashboard.
6
Wait for your server to be ready
In Akua, click Done to return to the app’s page. The page updates by itself: Server
shows your server as Ready a minute or two after it joined.
7
Check the settings
Open Settings. Some values may already be filled in or locked by the person who sent you
the link. If the app asks for values, fill them in and click Save and continue. If it shows
Nothing to set, there is nothing to do.
8
Install and open the app
Click Install app once. When the app is running, click Open app; View install
opens it in your dashboard. If you reload the page or open the link again, Akua shows the same
install instead of starting a second one.
When the app is running, Open app takes you to it.
The app’s address ends in akua.run and uses HTTPS. You can share it with your team; you don’t
need to set up DNS or certificates.
Use an Akua trial server instead
If you don’t have a server, click Start a trial server under An Akua server. Akua prepares
a small server for you on Hetzner. One trial server is available per person.In the short Add server setup, click Add card if Akua asks for one and verify a card; the
card is not charged. Click Start free trial server, then Done to return to the app’s page,
which shows the server as Ready once it is prepared. Then continue with the settings and
Install app.The trial server pauses days after it starts running, and
the app on it stops. Akua keeps a snapshot of its disk for days
after the pause, then deletes it with the app’s data. See Akua servers.
If the server doesn’t join
The command prints Akua join: messages. If it stops with an error, fix the cause it names, then
create a new join command and run it again. Common causes:
The Cluster refused the token in this join command. The command is wrong, expired or was
revoked, or could not be checked right now. Run it once more; if it is refused again, create a
new one. The command stops before it installs anything.
Run this command as root. Run it exactly as shown, including sudo.
This server belongs to another Cluster or An existing k0s installation is not managed by
this command. Start again with a fresh server.
Worker bootstrap timed out. The command shows the last lines of the worker’s log and stops
the worker. Check the server’s outbound connection, then create a new command and run it.
What the command installs and what it connects to.
Get help
Where to ask when something doesn’t work.
⌘I
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Akua | Docs","colors":{"primary":"#1577ff","light":"#64a5ff","dark":"#1f2dc1"},"logo":{"light":"https://mintcdn.com/akua-0b861dc6/7KPav8EV2jXc1gHe/logo.svg?fit=max\u0026auto=format\u0026n=7KPav8EV2jXc1gHe\u0026q=85\u0026s=0d393d8e1bb093fc520e0e6fd5a162a6","dark":"https://mintcdn.com/akua-0b861dc6/7KPav8EV2jXc1gHe/logo-dark.svg?fit=max\u0026auto=format\u0026n=7KPav8EV2jXc1gHe\u0026q=85\u0026s=d05d694672a3ac54ce30b1da31d456ac","href":"https://akua.dev"},"favicon":"https://mintcdn.com/akua-0b861dc6/o-ywDlh24ZayP_tj/favicon.svg?fit=max\u0026auto=format\u0026n=o-ywDlh24ZayP_tj\u0026q=85\u0026s=be16d4902aef96c6df2b98869527a55c","background":{"color":{"light":"#ffffff","dark":"#1F2023"}},"navbar":{"links":[{"href":"https://akua.dev/discord","label":"Discord Chat"}]},"footer":{"socials":{"github":"https://github.com/akua-dev","linkedin":"https://www.linkedin.com/company/akua-dev","x":"https://x.com/akua_dev"},"links":[{"header":"Explore","items":[{"label":"Quickstart","href":"https://docs.akua.dev/quickstart"},{"label":"Create a Product","href":"https://akua.dev/login?redirect=%2Fproducts%3Fcreate%3Dproduct"}]},{"header":"Resources","items":[{"label":"Blog","href":"https://akua.dev/blog"}]}]},"integrations":{"posthog":{"apiKey":"phc_pctNY25BoznqonkxmCXtbJKg3GpIHl4Ib1efrDOJRup","apiHost":"https://ph.akua.dev"}},"contextual":{"options":["copy","chatgpt","claude","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Use your coding agent","icon":"robot","href":"/agent-setup"},{"anchor":"CLI","icon":"terminal","href":"/cli"},{"anchor":"MCP","icon":"plug","href":"/ai/platform-mcp"},{"anchor":"API reference","icon":"brackets-curly","href":"/apis/introduction"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"akua-0b861dc6","hasAudioNarration":false,"actualSubdomain":"akua-0b861dc6","customDomains":["docs.akua.dev"],"gitSource":{"type":"github","owner":"akua-dev","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6b01b1e3b389ea779f779ec0","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Reference","count":231},{"language":"default","tag":"Endpoints","count":149},{"language":"default","tag":"akua pkg errors","count":47},{"language":"default","tag":"Error codes","count":46},{"language":"default","tag":"Get started","count":27},{"language":"default","tag":"akua pkg","count":25},{"language":"default","tag":"Sandboxes","count":25},{"language":"default","tag":"Organizations","count":13},{"language":"default","tag":"vaultSecrets","count":12},{"language":"default","tag":"Author and render","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"html.dark #almond-background-color{background:#191a1c!important}:root{--docs-dashboard-button-brand: oklch(0.5772 0.2324 260);--docs-dashboard-button-brand-hover: oklch(48.8% 0.243 264.376);--docs-dashboard-button-focus-ring: var(--docs-dashboard-button-brand)}a.group.bg-primary-dark[href=\"https://akua.dev/quickstart\"]{background-color:var(--docs-dashboard-button-brand)!important;border-color:var(--docs-dashboard-button-brand)!important;color:#ffffff!important}a.group.bg-primary-dark[href=\"https://akua.dev/quickstart\"]:hover{background-color:var(--docs-dashboard-button-brand-hover)!important;border-color:var(--docs-dashboard-button-brand-hover)!important}a.group.bg-primary-dark[href=\"https://akua.dev/quickstart\"]:focus-visible{outline:2px solid var(--docs-dashboard-button-focus-ring)!important;outline-offset:2px;box-shadow:0 0 0 3px var(--docs-dashboard-button-focus-ring)!important}a.tile div:has(>img[src^=\"/images/welcome/\"]),a.tile div:has(>img[src*=\"/images/welcome/\"]),a.tile div:has(>img[data-path^=\"images/welcome/\"]){padding:0!important}a.tile>div:has(img[src^=\"/images/welcome/\"]),a.tile>div:has(img[src*=\"/images/welcome/\"]),a.tile>div:has(img[data-path^=\"images/welcome/\"]){padding:0!important}a.tile img[src^=\"/images/welcome/\"],a.tile img[src*=\"/images/welcome/\"],a.tile img[data-path^=\"images/welcome/\"]{width:100%!important;height:100%!important;object-fit:cover}.akua-dg{container:akua-dg / inline-size;margin:1.75rem 0;--dg-fg: #111827;--dg-muted: #5b6576;--dg-line: #9aa3b2;--dg-surface: #ffffff}.akua-dg[data-vertical=\"true\"]{max-width:32rem;margin-left:auto;margin-right:auto}html.dark .akua-dg{--dg-fg: #e9edf7;--dg-muted: #9aa4b8;--dg-line: #5f6b80;--dg-surface: #1f2023}.akua-dg [data-tone]{--dg-bg: #f6f7f9;--dg-border: #dfe3ea;--dg-tag: #5b6576}.akua-dg [data-tone=\"you\"]{--dg-bg: #eef3fe;--dg-border: #bfd1fb;--dg-tag: #1556f0}.akua-dg [data-tone=\"customer\"],.akua-dg [data-tone=\"good\"]{--dg-bg: #ecf8f1;--dg-border: #b4e2c7;--dg-tag: #12764a}.akua-dg [data-tone=\"bad\"]{--dg-bg: #fdf1f1;--dg-border: #f3c4c4;--dg-tag: #b42318}.akua-dg [data-tone=\"outside\"]{--dg-bg: #ffffff;--dg-border: #cfd5df;--dg-tag: #5b6576}html.dark .akua-dg [data-tone]{--dg-bg: rgba(255, 255, 255, 0.04);--dg-border: rgba(255, 255, 255, 0.14);--dg-tag: #a3acbd}html.dark .akua-dg [data-tone=\"you\"]{--dg-bg: rgba(91, 141, 239, 0.13);--dg-border: rgba(91, 141, 239, 0.42);--dg-tag: #8aaaf7}html.dark .akua-dg [data-tone=\"customer\"],html.dark .akua-dg [data-tone=\"good\"]{--dg-bg: rgba(74, 199, 134, 0.1);--dg-border: rgba(74, 199, 134, 0.36);--dg-tag: #7fd8a8}html.dark .akua-dg [data-tone=\"bad\"]{--dg-bg: rgba(240, 100, 100, 0.1);--dg-border: rgba(240, 100, 100, 0.36);--dg-tag: #f4a3a3}html.dark .akua-dg [data-tone=\"outside\"]{--dg-bg: transparent;--dg-border: rgba(255, 255, 255, 0.22);--dg-tag: #a3acbd}.akua-dg-row,.akua-dg-group-body,.akua-dg-lane{display:flex;align-items:center}.akua-dg-node{flex:1 1 0;min-width:0;align-self:center;display:flex;flex-direction:column;justify-content:center;gap:0.2rem;min-height:4.6rem;padding:0.7rem 0.7rem;border:1px solid var(--dg-border);border-radius:0.65rem;background:var(--dg-bg);color:var(--dg-fg)}.akua-dg-tag{font-family:var(--font-paper-mono), ui-monospace, SFMono-Regular, Menlo, monospace;font-size:0.66rem;font-weight:500;line-height:1.2;letter-spacing:0.06em;text-transform:uppercase;color:var(--dg-tag)}.akua-dg-title{font-size:0.875rem;font-weight:600;line-height:1.3}.akua-dg-note{font-size:0.78rem;line-height:1.35;color:var(--dg-muted)}.akua-dg-stack{flex:1 1 0;min-width:0;align-self:center;display:grid;grid-auto-rows:1fr;gap:0.5rem}.akua-dg-stack:has(>.akua-dg-lane){flex-grow:3}.akua-dg-stack>.akua-dg-node,.akua-dg-group-body>.akua-dg-node,.akua-dg-lane>.akua-dg-node{align-self:stretch}.akua-dg-group{flex:2 1 0;min-width:0;align-self:stretch;display:flex;flex-direction:column;gap:0.5rem;padding:0.6rem;border:1px dashed var(--dg-border);border-radius:0.9rem;background:var(--dg-bg)}.akua-dg-row>.akua-dg-group{align-self:center}.akua-dg-group>.akua-dg-tag{padding:0 0.2rem}.akua-dg-group-body{flex:1 1 auto;gap:0.5rem}.akua-dg-group-body>.akua-dg-arrow{width:2rem;margin:0 -0.5rem;padding:0 0.2rem}.akua-dg-group-body>.akua-dg-arrow:has(.akua-dg-label){width:3.5rem}.akua-dg-group-body>.akua-dg-items{align-self:stretch}.akua-dg-node{overflow-wrap:break-word}.akua-dg-group .akua-dg-node[data-tone=\"neutral\"]{--dg-bg: var(--dg-surface)}.akua-dg-blocked{padding:0 0.2rem;font-size:0.75rem;line-height:1.35;color:#b42318}html.dark .akua-dg-blocked{color:#f4a3a3}.akua-dg-blocked::before{content:'\\2715';margin-right:0.35rem;font-weight:600}.akua-dg-state{align-self:flex-start;font-family:var(--font-paper-mono), ui-monospace, SFMono-Regular, Menlo, monospace;font-size:0.7rem;line-height:1.2;padding:0.1rem 0.35rem;border-radius:0.3rem;border:1px solid var(--dg-border);background:var(--dg-surface);color:var(--dg-tag)}.akua-dg-items{flex:1 1 auto;display:flex;flex-direction:column;gap:0.35rem;margin:0;padding:0;list-style:none}.akua-dg-items>li{margin:0;padding:0.4rem 0.6rem;border:1px solid var(--dg-border);border-radius:0.45rem;background:var(--dg-surface);font-size:0.8rem;line-height:1.3;color:var(--dg-fg)}.akua-dg-caption{margin:0.6rem 0 0;font-size:0.8rem;line-height:1.4;color:var(--dg-muted);text-align:center}.akua-dg-stack{position:relative;--dg-tick: 0.85rem;color:var(--dg-line)}.akua-dg-stack[data-merge=\"false\"]{padding-left:var(--dg-tick)}.akua-dg-stack[data-merge=\"true\"]{padding-right:var(--dg-tick)}.akua-dg-stack::before{content:'';position:absolute;top:25%;bottom:25%;width:1.5px;background:currentColor}.akua-dg-stack:has(>:nth-child(3))::before{top:calc(100% / 6);bottom:calc(100% / 6)}.akua-dg-stack[data-merge=\"false\"]::before{left:0}.akua-dg-stack[data-merge=\"true\"]::before{right:0}.akua-dg-stack>*{position:relative}.akua-dg-stack>*::before{content:'';position:absolute;top:50%;width:var(--dg-tick);height:1.5px;background:var(--dg-line)}.akua-dg-stack[data-merge=\"false\"]>*::before{left:calc(-1 * var(--dg-tick) - 1px);width:calc(var(--dg-tick) - 6px)}.akua-dg-stack[data-merge=\"false\"]>*::after{content:'';position:absolute;top:50%;left:-8px;border-top:4.5px solid transparent;border-bottom:4.5px solid transparent;border-left:7px solid var(--dg-line);transform:translateY(-50%)}.akua-dg-stack[data-merge=\"true\"]>*::before{right:calc(-1 * var(--dg-tick) - 1px)}.akua-dg-arrow:has(+.akua-dg-stack[data-merge=\"false\"]) .akua-dg-line{margin-right:0}.akua-dg-arrow:has(+.akua-dg-stack[data-merge=\"false\"]) .akua-dg-line::after{display:none}.akua-dg-arrow:has(+.akua-dg-stack[data-merge=\"false\"]),.akua-dg-stack[data-merge=\"true\"]+.akua-dg-arrow{padding-left:0;padding-right:0}.akua-dg-arrow{flex:0 0 auto;width:2.5rem;align-self:center;display:flex;flex-direction:column;align-items:stretch;gap:0.25rem;padding:0 0.3rem;color:var(--dg-line)}.akua-dg-arrow:has(.akua-dg-label){width:5.75rem}.akua-dg-label{font-size:0.7rem;line-height:1.25;text-align:center;color:var(--dg-muted)}.akua-dg-line{position:relative;display:block;height:1.5px;background:currentColor;margin:0 0.35rem 0 0}.akua-dg-line::after,.akua-dg-arrow[data-both=\"true\"] .akua-dg-line::before{content:'';position:absolute;top:50%;width:0;height:0;border-top:4.5px solid transparent;border-bottom:4.5px solid transparent;transform:translateY(-50%)}.akua-dg-line::after{right:-0.35rem;border-left:7px solid currentColor}.akua-dg-arrow[data-both=\"true\"] .akua-dg-line{margin-left:0.35rem}.akua-dg-arrow[data-both=\"true\"] .akua-dg-line::before{left:-0.35rem;border-right:7px solid currentColor}@container akua-dg (max-width: 540px){.akua-dg-row,.akua-dg-group-body,.akua-dg-lane{flex-direction:column;align-items:stretch}.akua-dg-node,.akua-dg-group,.akua-dg-row>.akua-dg-group,.akua-dg-stack{flex:0 0 auto;align-self:stretch;min-height:0}.akua-dg-stack{grid-auto-rows:auto;grid-auto-flow:column;grid-auto-columns:1fr}.akua-dg-stack>*{flex:1 1 0;min-width:0}.akua-dg-stack[data-merge=\"false\"]{padding:var(--dg-tick) 0 0}.akua-dg-stack[data-merge=\"true\"]{padding:0 0 var(--dg-tick)}.akua-dg-stack::before,.akua-dg-stack[data-merge=\"false\"]::before,.akua-dg-stack[data-merge=\"true\"]::before{top:auto;bottom:auto;left:25%;right:25%;width:auto;height:1.5px}.akua-dg-stack:has(>:nth-child(3))::before{left:calc(100% / 6);right:calc(100% / 6)}.akua-dg-stack[data-merge=\"false\"]::before{top:0}.akua-dg-stack[data-merge=\"true\"]::before{bottom:0}.akua-dg-stack>*::before,.akua-dg-stack[data-merge=\"false\"]>*::before,.akua-dg-stack[data-merge=\"true\"]>*::before{top:auto;right:auto;left:50%;width:1.5px;height:var(--dg-tick)}.akua-dg-stack[data-merge=\"false\"]>*::before{top:calc(-1 * var(--dg-tick) - 1px);height:calc(var(--dg-tick) - 6px)}.akua-dg-stack[data-merge=\"false\"]>*::after{top:-8px;left:50%;border:0;border-left:4.5px solid transparent;border-right:4.5px solid transparent;border-top:7px solid var(--dg-line);transform:translateX(-50%)}.akua-dg-stack[data-merge=\"true\"]>*::before{bottom:calc(-1 * var(--dg-tick) - 1px)}.akua-dg-arrow:has(+.akua-dg-stack[data-merge=\"false\"]) .akua-dg-line{margin-bottom:0}.akua-dg-arrow:has(+.akua-dg-stack[data-merge=\"false\"]),.akua-dg-stack[data-merge=\"true\"]+.akua-dg-arrow{padding-top:0;padding-bottom:0}.akua-dg-stack[data-merge=\"true\"]+.akua-dg-arrow .akua-dg-line{margin-top:0}.akua-dg-group-body>.akua-dg-arrow,.akua-dg-group-body>.akua-dg-arrow:has(.akua-dg-label){width:auto;margin:-0.5rem 0;padding:0.3rem 0}.akua-dg-arrow,.akua-dg-arrow:has(.akua-dg-label){position:relative;width:auto;height:2.1rem;align-self:stretch;flex-direction:row;justify-content:center;padding:0.3rem 0}.akua-dg-label{position:absolute;top:50%;left:calc(50% + 0.8rem);right:0;transform:translateY(-50%);text-align:left}.akua-dg-line{width:1.5px;height:auto;margin:0 0 0.35rem}.akua-dg-line::after,.akua-dg-arrow[data-both=\"true\"] .akua-dg-line::before{top:auto;left:50%;border:0;border-left:4.5px solid transparent;border-right:4.5px solid transparent;transform:translateX(-50%)}.akua-dg-line::after{right:auto;bottom:-0.35rem;border-top:7px solid currentColor}.akua-dg-arrow[data-both=\"true\"] .akua-dg-line{margin-top:0.35rem}.akua-dg-arrow[data-both=\"true\"] .akua-dg-line::before{top:-0.35rem;border-bottom:7px solid currentColor}}html.dark img.tab-icon[src$=\"-mono.svg\"]{filter:invert(1)}.tab-container>[data-component-part=\"tabs-list\"]{flex-wrap:wrap;row-gap:0.25rem}"}]}
{"page":{"pagePath":"guides/install-on-your-own-server","slug":"/guides/install-on-your-own-server","pageMetadata":{"title":"Install an app you received","description":"Someone sent you an Akua link. Install their app on your own Linux server, open it and keep control of it.","href":"/guides/install-on-your-own-server"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Someone sent you an Akua link. Install their app on your own Linux server, open it and keep control of it.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const planPolicy={\"trialMachineTtlDays\":7,\"trialExpiryAction\":`suspend`,\"snapshotRetentionDays\":90,\"resumeOnProUpgrade\":true,\"reminderMilestones\":[{\"id\":`5d`,\"amount\":5,\"unit\":`days`,\"label\":`5 days`,\"beforeMs\":432e6},{\"id\":`2d`,\"amount\":2,\"unit\":`days`,\"label\":`2 days`,\"beforeMs\":1728e5},{\"id\":`24h`,\"amount\":24,\"unit\":`hours`,\"label\":`24 hours`,\"beforeMs\":864e5}],\"aiForecastPercent\":80,\"aiIncludedPercent\":100,\"proAllowancePercent\":200,\"proGatewaySafetyPercent\":250,\"freeMonthlyAiBudgetUsd\":1,\"proMonthlyAiBudget\":{\"status\":`decided`,\"usd\":5},\"modelPriceTable\":{\"deepseek/deepseek-flash\":{\"inputUsdPerMTok\":.3,\"cachedInputUsdPerMTok\":.006,\"outputUsdPerMTok\":1.2,\"reasoningBilledAs\":`output`,\"effectiveFrom\":`2026-10-15`,\"source\":`https://api-docs.deepseek.com/quick_start/pricing/`},\"opencode/beam-free\":{\"inputUsdPerMTok\":0,\"cachedInputUsdPerMTok\":0,\"outputUsdPerMTok\":0,\"reasoningBilledAs\":`output`,\"effectiveFrom\":`2026-10-26`,\"source\":`https://opencode.ai/docs/zen/`}},\"machinePricingPolicy\":{\"feePercent\":5,\"perMachineOverheadEur\":1,\"roundingIncrementEur\":.5,\"rounding\":`up`,\"includeIpv4\":true,\"currency\":`EUR`,\"taxBasis\":`net`,\"revisitDeviationPercent\":25}};const billingPlans={\"free\":{\"id\":`free`,\"name\":`Free`,\"tagline\":`One managed machine to try it, or your own cloud from day one.`,\"monthlyPriceEur\":0,\"price\":{\"amount\":`€0`,\"period\":`/mo`,\"billingNote\":`No card required`},\"limits\":{\"managedClusters\":1,\"managedMachines\":1,\"cpuCores\":2,\"memoryGiB\":4,\"machineTtlDays\":7,\"instanceTypes\":`small`},\"behavior\":{\"trialMachine\":{\"trialExpiryAction\":`suspend`,\"snapshotRetentionDays\":90,\"resumeOnProUpgrade\":true},\"ai\":{\"monthlyBudgetUsd\":{\"status\":`decided`,\"usd\":1},\"scope\":`workspace`,\"aiForecastPercent\":80,\"aiIncludedPercent\":100,\"atBudget\":`upgrade-message`,\"allowancePercent\":100,\"additionalSpendCharge\":`none`}},\"presentation\":{\"persona\":[`Enough to try your first business tool.`],\"capacity\":[`Your trial machine is on us.`],\"capacityScope\":[`For running apps; the AI allowance is separate.`],\"aiAllowance\":[`AI help included, with an allowance.`],\"aiTaskEstimate\":[`Enough for about `,{\"fact\":`monthlyAiTasks`},` everyday AI tasks per month (estimate).`],\"limitPolicy\":[`We email you a forecast at `,{\"fact\":`aiForecastPercent`},`% of your AI allowance. At the allowance, you get a friendly upgrade message; nothing is charged automatically.`],\"trial\":[`Trial servers pause after `,{\"fact\":`trialDays`},` days: Akua shuts the server down, snapshots its disk and deletes the server. `,{\"fact\":`retentionDays`},` days later the snapshot is deleted too. Upgrading to Pro automatically restores the retained disk to the same server, which rejoins its Cluster if it belongs to a node pool. Recovery is available only while the snapshot exists; expired data cannot be recovered. You keep Pro even if your trial data expired.`]},\"support\":`Community`,\"billing\":`None`,\"features\":[{\"id\":`managed-clusters`,\"label\":`1 managed cluster`},{\"id\":`compute-machines`,\"label\":`1 managed machine as a one-time trial`},{\"id\":`compute-shape`,\"label\":`2 CPU cores, 4 GiB memory`},{\"id\":`instance-types`,\"label\":`Small instance types`},{\"id\":`machine-ttl`,\"label\":`Trial server pauses after 7 days; its snapshot is deleted 90 days later`},{\"id\":`byom`,\"label\":`Your own cloud key bypasses compute resource quotas`}]},\"pro\":{\"id\":`pro`,\"name\":`Pro`,\"tagline\":`Production on managed machines. Nothing expires.`,\"monthlyPriceEur\":20,\"price\":{\"amount\":`€20`,\"period\":`/mo`,\"billingNote\":`Per workspace, billed monthly`},\"limits\":{\"managedClusters\":3,\"managedMachines\":3,\"cpuCores\":8,\"memoryGiB\":16,\"machineTtlDays\":null,\"instanceTypes\":`all`},\"behavior\":{\"trialMachine\":null,\"ai\":{\"monthlyBudgetUsd\":{\"status\":`decided`,\"usd\":5},\"scope\":`workspace`,\"aiForecastPercent\":80,\"aiIncludedPercent\":100,\"atBudget\":`team-alert-and-continue`,\"allowancePercent\":200,\"additionalSpendCharge\":`none`}},\"presentation\":{\"persona\":[`Enough for the everyday tools of a small business.`],\"capacity\":[`Machines billed per machine, price shown before ordering.`],\"capacityScope\":[`Machine charges are separate from the platform subscription and AI allowance.`],\"aiAllowance\":[`AI help included, with extra room at our cost.`],\"aiTaskEstimate\":[`Enough for about `,{\"fact\":`monthlyAiTasks`},` everyday AI tasks per month (estimate).`],\"limitPolicy\":[`We email you a forecast at `,{\"fact\":`aiForecastPercent`},`% of your AI allowance. Your work keeps going up to `,{\"fact\":`proAllowanceMultiple`},`x the allowance at no extra charge, and our team is alerted when you reach the included allowance.`],\"trial\":[`Your apps keep running while the plan is active.`]},\"support\":`Standard`,\"billing\":`Monthly, set up with us`,\"features\":[{\"id\":`managed-clusters`,\"label\":`Up to 3 managed clusters`},{\"id\":`compute-machines`,\"label\":`Up to 3 managed machines`},{\"id\":`compute-shape`,\"label\":`8 CPU cores, 16 GiB memory`},{\"id\":`instance-types`,\"label\":`Every instance type your provider offers`},{\"id\":`machine-ttl`,\"label\":`No machine expiry`},{\"id\":`cancel`,\"label\":`Cancel any time`}]},\"enterprise\":{\"id\":`enterprise`,\"name\":`Enterprise`,\"tagline\":`Your own control plane, your own limits, our people to migrate you.`,\"monthlyPriceEur\":null,\"price\":{\"amount\":`Custom`,\"billingNote\":`Annual contract`},\"limits\":{\"managedClusters\":`custom`,\"managedMachines\":`custom`,\"cpuCores\":`custom`,\"memoryGiB\":`custom`,\"machineTtlDays\":null,\"instanceTypes\":`all-plus-reserved`},\"behavior\":{\"trialMachine\":null,\"ai\":null},\"presentation\":{\"persona\":[`Capacity planned around your company.`],\"capacity\":[`Managed compute capacity by agreement.`],\"capacityScope\":[`For running apps; the AI allowance is separate.`],\"aiAllowance\":[`AI allowance by agreement.`],\"aiTaskEstimate\":[],\"limitPolicy\":[`We agree your capacity and AI allowance with you.`],\"trial\":[`Hosting terms by agreement.`]},\"support\":`Dedicated engineering contact`,\"billing\":`Annual, usage-based, invoiced`,\"features\":[{\"id\":`custom-limits`,\"label\":`Custom limits per workspace`},{\"id\":`dedicated-control-plane`,\"label\":`Dedicated, isolated control planes`},{\"id\":`reserved-capacity`,\"label\":`Reserved capacity with any provider`},{\"id\":`dedicated-contact`,\"label\":`A dedicated engineering contact`},{\"id\":`migration`,\"label\":`Hands-on migration support`},{\"id\":`invoicing`,\"label\":`One consolidated invoice, usage-based`}]}};function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,Frame,Heading,Step,Steps,ZoomImage}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!ZoomImage)_missingMdxReference(`ZoomImage`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Someone sent you a link to their app, and you want to run your own copy of it on your own server.\nFor example, an agency built a booking app for you and wants it to run on a server your company\npays for, with your data staying there. This guide takes you from the link to the running app.`}),`\n`,_jsx(Heading,{level:`2`,id:`what-happens-to-your-server`,children:`What happens to your server`}),`\n`,_jsxs(_components.p,{children:[`You run one command on your server. It installs the Kubernetes worker software (k0s) and\nconnects your server to Akua, which then starts the app on it. The app and its data run on your\nserver, and you pay your server provider directly. The person who sent you the link can’t sign\nin to your account or change your copy of the app. `,_jsx(_components.a,{href:`/customers/what-runs-on-your-server`,children:`What runs on your server`}),`\nlists everything the command installs.`]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The link you received.`}),`\n`,_jsx(_components.li,{children:`An email address to sign in to Akua. Signing in creates your Akua account if you don’t have one.`}),`\n`,_jsxs(_components.li,{children:[`A Linux server that meets the `,_jsx(_components.a,{href:`/customers/server-requirements`,children:`server requirements`}),`: at least\n2 CPUs and 4 GB of memory, root access over SSH, and outbound internet access. Akua tests\nUbuntu 24.04 on x86-64. Use a fresh server that runs nothing else. No server? Use an\n`,_jsx(_components.a,{href:`#use-an-akua-trial-server-instead`,children:`Akua trial server`}),` instead.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`install-the-app`,children:`Install the app`}),`\n`,_jsxs(_components.p,{children:[`The app’s page shows two ways to run it: `,_jsx(_components.strong,{children:`Your own server`}),`, which this guide follows, or\n`,_jsx(_components.strong,{children:`An Akua server`}),`, a free trial server that Akua prepares for you (see\n`,_jsx(_components.a,{href:`#use-an-akua-trial-server-instead`,children:`Use an Akua trial server instead`}),`).`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the link and sign in`,children:_jsxs(_components.p,{children:[`Open the link and click `,_jsx(_components.strong,{children:`Sign in to continue`}),` (or `,_jsx(_components.strong,{children:`Sign in`}),`, if the page says `,_jsx(_components.strong,{children:`Sign in to\nsee your invitation`}),`). Enter your email address, click\n`,_jsx(_components.strong,{children:`Continue with Email`}),` and follow the link in the email you receive. If the link was sent to\nyour email address, sign in with that one. You come back to the app’s page, which now has two\nparts, `,_jsx(_components.strong,{children:`Server`}),` and `,_jsx(_components.strong,{children:`Settings`}),`, and an `,_jsx(_components.strong,{children:`Install app`}),` button.`]})}),_jsx(Step,{title:`Choose your Workspace`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Server`}),`, choose the `,_jsx(_components.strong,{children:`Workspace`}),` that should own the app. A Workspace is your own\nspace in Akua; the app, its server and its settings belong to it. If you have no Workspace yet,\nenter a `,_jsx(_components.strong,{children:`Workspace name`}),`. If you have no Organization yet either, also enter an\n`,_jsx(_components.strong,{children:`Organization name`}),`, such as your company’s name. Click `,_jsx(_components.strong,{children:`Create Workspace`}),`.`]})}),_jsx(Step,{title:`Add your server`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Your own server`}),`, click `,_jsx(_components.strong,{children:`Add a server`}),`. `,_jsx(_components.strong,{children:`Review your server`}),` shows the group your\nserver joins: Akua creates it for you, named after your Workspace, in its default region.\nClick `,_jsx(_components.strong,{children:`Change`}),` if you want another name or region. Click `,_jsx(_components.strong,{children:`Create join command`}),`.`]})}),_jsxs(Step,{title:`Copy the join command`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Connect your server`}),` shows the command in a `,_jsx(_components.strong,{children:`Shell`}),` block. Click `,_jsx(_components.strong,{children:`Copy command`}),`. The\ncommand is for one server: it stops working 15 minutes after its first use, or after one hour\nif it is not used. It is shown only on this page.`]}),_jsx(_components.p,{children:`Keep the command private: anyone who runs it can add a server to your Workspace.`})]}),_jsx(Step,{title:`Run the command on your server`,children:_jsxs(_components.p,{children:[`Connect to your server over SSH and run the command exactly as shown. It starts with\n`,_jsx(_components.code,{children:`curl -fsSL`}),` and downloads `,_jsx(_components.code,{children:`join.sh`}),` from Akua, then runs it with `,_jsx(_components.code,{children:`sudo sh join.sh`}),`, so it runs\nas root. It first checks the command’s token, then installs the worker software and joins\nyour server. It prints `,_jsx(_components.code,{children:`Akua join:`}),` messages and ends with\n`,_jsx(_components.code,{children:`Worker joined and started; wait for Ready in the dashboard`}),`.`]})}),_jsx(Step,{title:`Wait for your server to be ready`,children:_jsxs(_components.p,{children:[`In Akua, click `,_jsx(_components.strong,{children:`Done`}),` to return to the app’s page. The page updates by itself: `,_jsx(_components.strong,{children:`Server`}),`\nshows your server as `,_jsx(_components.strong,{children:`Ready`}),` a minute or two after it joined.`]})}),_jsx(Step,{title:`Check the settings`,children:_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Settings`}),`. Some values may already be filled in or locked by the person who sent you\nthe link. If the app asks for values, fill them in and click `,_jsx(_components.strong,{children:`Save and continue`}),`. If it shows\n`,_jsx(_components.strong,{children:`Nothing to set`}),`, there is nothing to do.`]})}),_jsxs(Step,{title:`Install and open the app`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Install app`}),` once. When the app is running, click `,_jsx(_components.strong,{children:`Open app`}),`; `,_jsx(_components.strong,{children:`View install`}),`\nopens it in your dashboard. If you reload the page or open the link again, Akua shows the same\ninstall instead of starting a second one.`]}),_jsx(Frame,{caption:`When the app is running, Open app takes you to it.`,children:_jsx(ZoomImage,{children:_jsxs(`picture`,{children:[_jsx(`source`,{media:`(max-width: 640px)`,srcSet:`/images/guides/customer-app-running-390.webp`,width:`390`,height:`134`}),_jsx(`img`,{noZoom:true,src:`https://mintcdn.com/akua-0b861dc6/jOq32pkmOz2zt_vy/images/guides/customer-app-running-1440.webp?fit=max\u0026auto=format\u0026n=jOq32pkmOz2zt_vy\u0026q=85\u0026s=dad658641072baee981c317ad47cd43c`,alt:`Confirmation that the shared app is running, with View install and Open app controls.`,width:`1440`,height:`158`,\"data-og-width\":`1440`,\"data-og-height\":`158`,\"data-path\":`images/guides/customer-app-running-1440.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/akua-0b861dc6/jOq32pkmOz2zt_vy/images/guides/customer-app-running-1440.webp?w=280\u0026fit=max\u0026auto=format\u0026n=jOq32pkmOz2zt_vy\u0026q=85\u0026s=5d88fb548ce27719f400c93b622bdd2f 280w, https://mintcdn.com/akua-0b861dc6/jOq32pkmOz2zt_vy/images/guides/customer-app-running-1440.webp?w=560\u0026fit=max\u0026auto=format\u0026n=jOq32pkmOz2zt_vy\u0026q=85\u0026s=1ed4e2d1b151781b4ea0a319c2a54b3c 560w, https://mintcdn.com/akua-0b861dc6/jOq32pkmOz2zt_vy/images/guides/customer-app-running-1440.webp?w=840\u0026fit=max\u0026auto=format\u0026n=jOq32pkmOz2zt_vy\u0026q=85\u0026s=efe4e58fa8d2eeaeaac8617df76c4ab0 840w, https://mintcdn.com/akua-0b861dc6/jOq32pkmOz2zt_vy/images/guides/customer-app-running-1440.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=jOq32pkmOz2zt_vy\u0026q=85\u0026s=02b1805b7157a21be706235fd31e1535 1100w, https://mintcdn.com/akua-0b861dc6/jOq32pkmOz2zt_vy/images/guides/customer-app-running-1440.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=jOq32pkmOz2zt_vy\u0026q=85\u0026s=b14d55400937f3287e583479c689ad72 1650w, https://mintcdn.com/akua-0b861dc6/jOq32pkmOz2zt_vy/images/guides/customer-app-running-1440.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=jOq32pkmOz2zt_vy\u0026q=85\u0026s=7fac4ea6bbec7686d610ceb84cd97a86 2500w`})]})})})]})]}),`\n`,_jsxs(_components.p,{children:[`The app’s address ends in `,_jsx(_components.code,{children:`akua.run`}),` and uses HTTPS. You can share it with your team; you don’t\nneed to set up DNS or certificates.`]}),`\n`,_jsx(Heading,{level:`2`,id:`use-an-akua-trial-server-instead`,children:`Use an Akua trial server instead`}),`\n`,_jsxs(_components.p,{children:[`If you don’t have a server, click `,_jsx(_components.strong,{children:`Start a trial server`}),` under `,_jsx(_components.strong,{children:`An Akua server`}),`. Akua prepares\na small server for you on Hetzner. One trial server is available per person.`]}),`\n`,_jsxs(_components.p,{children:[`In the short `,_jsx(_components.strong,{children:`Add server`}),` setup, click `,_jsx(_components.strong,{children:`Add card`}),` if Akua asks for one and verify a card; the\ncard is not charged. Click `,_jsx(_components.strong,{children:`Start free trial server`}),`, then `,_jsx(_components.strong,{children:`Done`}),` to return to the app’s page,\nwhich shows the server as `,_jsx(_components.strong,{children:`Ready`}),` once it is prepared. Then continue with the settings and\n`,_jsx(_components.strong,{children:`Install app`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`The trial server pauses `,billingPlans.free.limits.machineTtlDays,` days after it starts running, and\nthe app on it stops. Akua keeps a snapshot of its disk for `,planPolicy.snapshotRetentionDays,` days\nafter the pause, then deletes it with the app’s data. See `,_jsx(_components.a,{href:`/compute/overview`,children:`Akua servers`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`if-the-server-doesn’t-join`,children:`If the server doesn’t join`}),`\n`,_jsxs(_components.p,{children:[`The command prints `,_jsx(_components.code,{children:`Akua join:`}),` messages. If it stops with an error, fix the cause it names, then\ncreate a new join command and run it again. Common causes:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The Cluster refused the token in this join command.`}),` The command is wrong, expired or was\nrevoked, or could not be checked right now. Run it once more; if it is refused again, create a\nnew one. The command stops before it installs anything.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Run this command as root.`}),` Run it exactly as shown, including `,_jsx(_components.code,{children:`sudo`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`This server belongs to another Cluster`}),` or `,_jsx(_components.strong,{children:`An existing k0s installation is not managed by\nthis command.`}),` Start again with a fresh server.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Worker bootstrap timed out.`}),` The command shows the last lines of the worker’s log and stops\nthe worker. Check the server’s outbound connection, then create a new command and run it.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`For anything else, see `,_jsx(_components.a,{href:`/customers/get-help`,children:`Get help`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Update or remove the app`,icon:`arrows-rotate`,href:`/customers/update-or-remove`,children:_jsx(_components.p,{children:`New versions of the app, and how to remove it.`})}),_jsx(Card,{title:`What runs on your server`,icon:`server`,href:`/customers/what-runs-on-your-server`,children:_jsx(_components.p,{children:`What the command installs and what it connects to.`})}),_jsx(Card,{title:`Get help`,icon:`life-ring`,href:`/customers/get-help`,children:_jsx(_components.p,{children:`Where to ask when something doesn’t work.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{planPolicy,billingPlans,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Install an app you received","description":"Someone sent you an Akua link. Install their app on your own Linux server, open it and keep control of it.","href":"/guides/install-on-your-own-server"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[145,6469,"undefined;const billingPlans=undefined;f"],[16778,16818,""],[16915,16948,""]]},"mdxExtracts":{"tableOfContents":[{"title":"What happens to your server","slug":"what-happens-to-your-server","depth":2,"children":[]},{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Install the app","slug":"install-the-app","depth":2,"children":[]},{"title":"Use an Akua trial server instead","slug":"use-an-akua-trial-server-instead","depth":2,"children":[]},{"title":"If the server doesn’t join","slug":"if-the-server-doesn’t-join","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"akua-0b861dc6","siteName":"Akua | Docs","title":"Install an app you received - Akua | Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-21T14:59:59.838Z","originalFileLocation":"guides/install-on-your-own-server.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Someone sent you an Akua link. Install their app on your own Linux server, open it and keep control of it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Akua | Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/akua-0b861dc6/JcRwJjK7QgFYjJ80/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/akua-0b861dc6/JcRwJjK7QgFYjJ80/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/akua-0b861dc6/JcRwJjK7QgFYjJ80/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/akua-0b861dc6/JcRwJjK7QgFYjJ80/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/akua-0b861dc6/JcRwJjK7QgFYjJ80/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/akua-0b861dc6/JcRwJjK7QgFYjJ80/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/akua-0b861dc6/JcRwJjK7QgFYjJ80/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/akua-0b861dc6/JcRwJjK7QgFYjJ80/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/akua-0b861dc6/JcRwJjK7QgFYjJ80/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Install an app you received - Akua | Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Someone sent you an Akua link. Install their app on your own Linux server, open it and keep control of it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Akua | Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.akua.dev/guides/install-on-your-own-server\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://akua-0b861dc6.mintlify.site/_mintlify/api/og/v2?division=Install+an+app+you+received\u0026amp;title=Install+an+app+you+received\u0026amp;description=Someone+sent+you+an+Akua+link.+Install+their+app+on+your+own+Linux+server%2C+open+it+and+keep+control+of+it.\u0026amp;theme=1fb0afe38053214a0649d0ba\u0026amp;signature=9d4e8dc065bb5af1a328197fba8b02ed3edb58c0755235e659b93fc85bd823eb\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Install an app you received - Akua | Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Someone sent you an Akua link. Install their app on your own Linux server, open it and keep control of it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://akua-0b861dc6.mintlify.site/_mintlify/api/og/v2?division=Install+an+app+you+received\u0026amp;title=Install+an+app+you+received\u0026amp;description=Someone+sent+you+an+Akua+link.+Install+their+app+on+your+own+Linux+server%2C+open+it+and+keep+control+of+it.\u0026amp;theme=1fb0afe38053214a0649d0ba\u0026amp;signature=9d4e8dc065bb5af1a328197fba8b02ed3edb58c0755235e659b93fc85bd823eb\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/akua-0b861dc6/JcRwJjK7QgFYjJ80/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Akua | Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1577ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.akua.dev/guides/install-on-your-own-server\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/install-on-your-own-server.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.akua.dev/#organization\",\"name\":\"Akua | Docs\",\"url\":\"https://docs.akua.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/akua-0b861dc6/7KPav8EV2jXc1gHe/logo.svg?fit=max\u0026auto=format\u0026n=7KPav8EV2jXc1gHe\u0026q=85\u0026s=0d393d8e1bb093fc520e0e6fd5a162a6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.akua.dev#website\",\"name\":\"Akua | Docs\",\"url\":\"https://docs.akua.dev\",\"publisher\":{\"@id\":\"https://docs.akua.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.akua.dev/guides/install-on-your-own-server#webpage\",\"url\":\"https://docs.akua.dev/guides/install-on-your-own-server\",\"name\":\"Install an app you received\",\"description\":\"Someone sent you an Akua link. Install their app on your own Linux server, open it and keep control of it.\",\"dateModified\":\"2026-11-21T14:59:59.838Z\",\"isPartOf\":{\"@id\":\"https://docs.akua.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.akua.dev/guides/install-on-your-own-server#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.akua.dev/guides/install-on-your-own-server#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Akua | Docs\",\"item\":\"https://docs.akua.dev\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Install an app you received\",\"item\":\"https://docs.akua.dev/guides/install-on-your-own-server\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.akua.dev/guides/install-on-your-own-server#article\",\"headline\":\"Install an app you received\",\"name\":\"Install an app you received\",\"description\":\"Someone sent you an Akua link. Install their app on your own Linux server, open it and keep control of it.\",\"url\":\"https://docs.akua.dev/guides/install-on-your-own-server\",\"mainEntityOfPage\":{\"@id\":\"https://docs.akua.dev/guides/install-on-your-own-server#webpage\"},\"dateModified\":\"2026-11-21T14:59:59.838Z\",\"publisher\":{\"@id\":\"https://docs.akua.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.akua.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Akua | Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Akua | Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides/install-on-your-own-server.md","siteName":"Akua | Docs","nav":{"global":{"anchors":[{"anchor":"Use your coding agent","icon":"robot","href":"/agent-setup"},{"anchor":"CLI","icon":"terminal","href":"/cli"},{"anchor":"MCP","icon":"plug","href":"/ai/platform-mcp"},{"anchor":"API reference","icon":"brackets-curly","href":"/apis/introduction"}]},"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":""}]},{"tab":"For customers","groups":[{"group":"Install an app you received","pages":[{"title":"Install an app you received","href":"/guides/install-on-your-own-server"},{"title":"Server requirements","description":"The server you need to install an app you received: Linux with 2 CPUs, 4 GB of memory, root SSH access and outbound internet; Akua tests Ubuntu 24.04 on x86-64","href":"/customers/server-requirements"},{"title":"What runs on your server","href":"/customers/what-runs-on-your-server"}]},{"group":"Run your app","pages":[{"title":"Update or remove the app","href":"/customers/update-or-remove"},{"title":"Get help","href":"/customers/get-help"}]}]},{"tab":"Trust","pages":[{"title":"Trust","href":"/trust/about"}]},{"tab":"Reference","pages":[{"title":"Reference","href":"/cli"}]}]},"basePath":"","title":"Install an app you received - Akua | Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}