Getting started — first project

Before you begin

• A GitHub account with permission to create or use a repository.
• An Ubuntu/Debian VPS you can reach over SSH (root or a sudo-capable user).
• Your WayHost account must be approved (first-time GitHub sign-in may show “pending approval” until a platform admin approves you).

Platform subdomain DNS (Cloudflare) is configured by a super admin — you do not set that in the wizard. Custom domains can be added later on each branch.

Sign in

1. Open WayHost → Sign in with GitHub.
2. Authorize the requested scopes (repos, webhooks, etc.).
3. If you see Account pending approval, wait for an admin. You will get an in-app notification and email when approved.
4. After approval, open Dashboard.

Create a project

From the dashboard choose New project. The wizard has five steps:

1. Project

• Enter a name (at least 2 characters) and optional description.
• WayHost suggests a slug used in URLs. Check that it is available.

2. Repository

• Create new — WayHost creates a private GitHub repo for you, or
• Use existing — pick owner/repo and default branch.

One GitHub repository maps to one WayHost project. For organization repos, re-authorize GitHub with org access if create fails.

3. Odoo

• Version (for example 18.0), edition Community or Enterprise, and Odoo HTTP port (default 8069).
• Enterprise requires a subscription code and that the platform has enterprise GitHub access configured.

4. Server

• SSH host, port, username, and authentication (private key or password).
• Click Test connection — it must succeed before you continue.
• If you use a non-root user with an SSH key, you may need to provide an account password for sudo unless passwordless sudo is already set up.

5. Review

Confirm and create. You land on the project page while provisioning runs (Docker stack, git, deploy key, webhook when possible).

After create

• Open Branches → production to see URL, Connect, Sync, Backups, Domain, Shell.
• If auto-deploy is inactive, the platform may need a public WEBHOOK_PUBLIC_URL / domain — ask your platform admin.
• Invite colleagues under Team (they must sign into WayHost once first).

Common pitfalls

• SSH test fails — check firewall, key format, and sudo.
• Still pending approval — you cannot open the dashboard until approved.
• No platform subdomain — project can still work; add a custom domain later or ask admin to configure Cloudflare.