FAQ

Short answers to the questions people ask us first. Where the docs make no promise, we say so here rather than guess.

Access

How do I get a token?

Run etorm login, which signs you in and writes a kubeconfig with a personal token. You can also use kubectl access in the console. For automation, create a service account and give it a token of its own. See Sign in and get kubectl access and Automate with a service account.

Is there a download for the etorm tool?

No. Build it from source with cargo build --release -p etorm. If you only need to sign in, the console does the same thing.

Do tokens expire?

Yes. Below platform level, a token lasts 90 days by default and 365 at most. etorm login asks for 30 days unless you pass --days. To rotate a token, create a new one and delete the old one.

I lost a token. Can you show it again?

No. We store only a hash of it, so there is nothing to show. Create a new token and delete the old one with kubectl delete apitoken <name>.

Why do I get 403?

Either your role does not allow the action, or you have reached a quota. Everything is denied unless a role allows it, so ask an owner for a role. To check what a principal may do, use a SubjectAccessReview. See Security model and the error table.

Can I require two-step verification for my team?

No. Each person decides for themselves, and an account or project cannot require it. See Protect your account with two-step verification.

Projects and resources

What is the address of my project?

A project named acme-prod answers at https://acme-prod-api.etorm.com. The platform itself, where billing accounts and projects live, is at https://api.etorm.com. See Create a billing account and a project.

Why is my object Pending?

Its controller is waiting for something, and status.conditions tells you what. Read the reason there. Two common cases are a service waiting for its VPC to become Ready, and a process with NoNode because no machine is attached to run it. See Find out why something stays Pending.

What does Ready mean?

The controller has made the object match its spec. For a VPC, that means its addresses exist. For a process, it means the process is placed and running. A process with nothing to do is still Ready. Only Ready objects are metered.

Why was my manifest rejected with 422?

The object is invalid, and the message names the field. We reject unknown fields instead of ignoring them, and some fields cannot change after creation. The generated pages under Resources list every field with its limits.

How do I delete a project?

Delete the Project object. The platform removes every object in it and then the project itself. This takes a moment, and it cannot be undone. You cannot delete a billing account while a project still uses it. See Delete things safely.

What regions exist?

The docs do not publish a list of regions. A process has a placement.region field that defaults to auto, which places it next to its VPCs. The field's description uses eu, us and apac as examples. Treat any other statement about where things run as unannounced.

Networking

Do I need IPv4?

No. Every VPC has an IPv6 /64 and works with IPv6 alone. If you want dual-stack, add a cidr to the VPC. Nothing requires an IPv4 address. See IPv6 and Add IPv4, DHCP and DNS to a VPC.

How does a machine join a VPC?

Create an Account for it. Then connect the machine over WireGuard to a gateway, with an Ethernet tunnel inside. You generate the key, and Etorm only sees the public half. See Connect a Linux machine to a VPC.

Can I use load balancers and ingress?

Load balancing is by invitation, so ask us for access. Until the engine is enabled for your project, a new load balancer or ingress stays Pending with reason EngineNotAvailable. See Balance traffic and accept it at the edge.

Compute, storage and data services

What can I run?

A Program is a WebAssembly module of up to 256 KiB, checked when you register it. A Process runs that program with Ethernet interfaces on your VPCs, and frames wake it. See Write your first program and the Compute reference. Beyond the placement field, the docs make no promise about where processes run.

How big can an object be?

32 MiB, and that limit is the same for every bucket. There is no multipart upload, no range reads, no signed URLs and no public buckets. You always use an API token. See Store objects in a bucket.

Can I create a database or a message broker?

Both are by invitation, so ask us for access. Concepts explains what they are, and Service access shows how to get each service.

Billing

How are things billed?

An object is metered while it is Ready, per project and month, at an hourly price set by a SKU. Amounts are integer micro-units of the billing account's currency, which is USD by default. Deleting an object stops its metering. See Billing and usage.

Is there a free tier?

We have not announced one, and nothing in the platform defines one.

What do things cost? Will I get an invoice?

We do not publish prices, and the prices in the platform's price list are placeholders. Usage is recorded, but there are no invoices, payments, quotas or suspension for unpaid usage. You can read your metered usage with kubectl --context etorm get usages.

More

Is my data encrypted?

Yes. Control-plane data is encrypted before it is stored, and every object in a bucket is encrypted with that bucket's keys. There has been no independent security review, and we hold no compliance certification. See Security model.

Is there an SLA?

We do not publish one. For live platform health see status.etorm.com. Service access shows how to get each service, and What's new lists changes.

Which words do the docs use?

See the Glossary.