# Deploy Ocular with Easypanel

URL: /templates/ocular

Ocular is a self-hosted budget and finance app with dashboards, charts, multi-year tracking, imports, and authentication. This template runs the official container image, which bundles the static UI (Caddy) and the Genesis API backend, with persistent data under /data/genesis.

## Installation notes

After deploy, open your domain and sign in using the initial user from GENESIS_CREATE_USERS (default is admin with a random password set at deploy time; copy it from the service environment if you did not set your own value). Use HTTPS in production; only enable HTTP cookies if you access the app without TLS. Change GENESIS_JWT_SECRET only if you understand that existing sessions will be invalidated.

## Benefits

### Budget clarity

Dashboards and analytics help you understand spending and plans over time.

### Self-hosted

Keep financial data on infrastructure you control.

### Official image

Uses the published GHCR image maintained by the project.

## Features

### Multi-year budgets

Track and carry budgets across years with flexible financial calendars.

### Import and export

Bring data from common formats and export your work as JSON.

### Genesis backend

API and authentication via the bundled Genesis server (JWT configurable).

## Configuration

- `appServiceName` (App Service Name, required): ocular

- `appServiceImage` (Ocular Image, required): ghcr.io/simonwep/ocular:v2.3.0

- `genesisJwtTokenExpiration` (JWT token expiration (ms)): 120000

- `genesisJwtCookieAllowHttp` (Allow JWT cookie over HTTP (not recommended behind HTTPS)): false

- `genesisCreateUsers` (Initial users (Genesis format)): Set during installation — Comma-separated list of username!:password entries. Leave empty to create a single admin user with a random password.

## Services

- ocular: app (ghcr.io/simonwep/ocular:v2.3.0)

## Resources

- [Website](https://simonwep.github.io/ocular/)

- [Documentation](https://simonwep.github.io/ocular/pages/quickstart)

- [Deploy guide](https://simonwep.github.io/ocular/pages/deploy.html)

- [GitHub](https://github.com/simonwep/ocular)

- [Container registry](https://github.com/simonwep/ocular/pkgs/container/ocular)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/ocular)