Skip to main content
Ready to deploy? Start Free Trial
Documentation

Getting started

Platform overview, quick-start, login flow, and a tour of the dashboard.

Back to docs index

Platform Overview

CloudWady is a professional deployment platform that automates the provisioning, deployment, and management of Odoo applications. It integrates cloud providers, Git repositories, infrastructure automation, and real-time monitoring into a unified dashboard.

Key Capabilities

  • Multi-Environment Projects: Organize deployments into Production, Staging, and Development environments.
  • Automated Deployments: One-click deploy, update, backup, and restore — fully automated, no manual server commands.
  • Git Integration: Connect GitHub repositories via GitHub App for automatic branch tracking and webhook-triggered deployments.
  • Cloud Provisioning: Auto-provision servers on Hetzner, DigitalOcean, with Cloudflare DNS and SSL management.
  • Real-Time Monitoring: Embedded Grafana dashboards for CPU, memory, disk, network metrics, and application logs.
  • Alerting System: Proactive backup, SSL, server cleanup, and core addons update alerts with integration channels (Email, PagerDuty, OpsGenie, webhooks).
  • Role-Based Access: Granular per-company permissions from Viewer to Admin with environment-specific controls.

Quick Start Guide

Get your first Odoo application deployed in minutes:

  1. Log in to the Dashboard - Access your CloudWady dashboard. You will land on the main Overview screen.
  2. Create a Project - Navigate to a project and use "New Deployment App" in the environment toolbar, or use the project creation wizard to set up a complete project with server and environment.
  3. Review Your Project - Once created, the project dashboard shows your environments (Production, Staging, Development) with server metrics and app cards.
  4. Configure Your App - Open the app to set the Odoo version, edition, Git branch, and environment variables.
  5. Deploy - Click the Deploy button. CloudWady builds and deploys your application automatically.
  6. Monitor - Watch deployment progress in real-time via workflow logs. Once complete, click "Open" to access your running Odoo instance.
Tip: After your first deployment, update your app with a single click whenever you push new code to your Git branch.

Login & Onboarding

Access the CloudWady platform through the login page. New users are guided through terms acceptance before reaching the dashboard.

How to Access: Navigate to your CloudWady instance URL (e.g., https://your-domain.com/web/login).
CloudWady Login Page
  1. Email & password — enter the credentials your administrator issued, then Log in.
  2. Reset Password — request a reset link if you've forgotten your password.
  3. Log in with GitHub / Sign in with Google — single sign-on, when enabled for your instance.

Login Methods

  • Email & Password: Enter your email address and password in the login form.
  • GitHub OAuth: Click "Log in with GitHub" to authenticate via your GitHub account (requires GitHub App integration).

Common Tasks

Logging In for the First Time
  1. Open the Login Page - Navigate to your CloudWady URL. You will see the login form with email and password fields.
  2. Enter Credentials - Fill in the email and password provided by your administrator.
  3. Accept Terms - On first login, you will be presented with the Terms and Conditions. Scroll through the full document, check the acceptance checkbox, and click "Accept".
  4. Dashboard Landing - After acceptance, you land on the main deployment dashboard.
Tip: If you forget your password, ask your platform administrator to send a password reset email from the Users management screen.
Related: See User Management for creating accounts, and Access Levels for permission details.

Understanding the Dashboard

The main dashboard is your command center, providing a high-level overview of your entire platform.

How to Access: Sidebar Overview, or navigate to /deployment/dashboard?menu=overview
CloudWady Dashboard Overview
  1. Sidebar — grouped navigation (Overview, Projects, Operations, Reliability, and more).
  2. Attention banners — backup alerts and other items needing action surface at the top.
  3. Stat cards — Apps, Servers, Pipeline runs, and Workflow Health at a glance.
  4. Instance Health — per-environment status of every running app, filterable by stage.

Dashboard Sidebar

The left sidebar groups the platform into sections. Everyday sections (Overview, Projects, Operations, Reliability) are always visible; the infrastructure and automation sections require maintainer access, and the Platform section is operator-only. Each row below links straight to its screen.

Section Menu items What it's for Min. role
Overview Overview, Matrix Platform summary and the cross-environment status matrix. All
Projects Projects, Backups Your projects and the company-wide backup catalog. All
Operations Workflows, Runners, Queues, Reconciliation Automation runs, worker activity, job queues, and drift reconciliation. All
Reliability Monitoring, Alerts Embedded Grafana metrics and the alert inbox. All
Infrastructure Servers, Storage, Installers Provisioned servers, storage boxes, and platform installers. Maintainer
Integrations Cloud Providers, Domains, Git Providers, Git Repositories Hetzner/DigitalOcean, Cloudflare DNS, the GitHub App, and connected repositories. Maintainer
Automation Library Playbooks, Templates, Template Overrides, Playbook Overrides Ansible playbooks and Jinja templates, plus per-company overrides. Maintainer
Marketplace App Store, Upgrade One-click marketplace apps and plan upgrades. Developer+
Settings Personal Settings, Team & Access, Billing & Subscriptions, Add-ons, Branding, Company Settings Profile & notifications, team permissions, billing, add-on subscriptions, white-label branding, and namespace configuration. Maintainer / Admin
Platform Review Queue, Domain Migration, Routing Migration Operator tools: namespace review and domain/routing migrations. Operator

Status cards & attention banners

Across the top are at-a-glance cards — Apps (with how many are running), Servers (online count), Pipeline (recent automation failures), and Workflow Health (success rate, flagged Below Gate when it dips under the threshold). Above them, attention banners surface anything that needs action, such as production backups that are failing or stale.

Backup health & Instance Health

A backup-health bar summarizes how many production apps have healthy versus critical backups. Below it, the Instance Health list shows every running app grouped by environment (Production, Staging, Development) with its runtime, version, and namespace, and is filterable by stage.

GitHub App integration

When the GitHub App is connected, a card shows the app, an Installed badge, the number of linked repositories, the company, and the connected GitHub account — with Update and Fetch actions to re-sync.

Available Actions

Action Description Access Level
GitHub App: Update Sync GitHub App data and repositories Maintainer
GitHub App: Fetch Fetch latest repository info from GitHub Maintainer
Next: Projects & environments