Project Management That Works for Developers

Detailed setup guide with screenshots (Japanese) →

1. 1

   Clone, configure, and start

   Clone the repository, copy .env.example to .env, and fill in DB_PASSWORD and JWT_SECRET_KEY — the sed line below generates random values for you (macOS / Linux / WSL). Then start with Docker Compose. It stops right away with a clear message if either value is empty.

   git clone https://github.com/macplanning-labs/senn.git
   cd senn
   cp .env.example .env
   sed -i.bak "s|^DB_PASSWORD=.*|DB_PASSWORD=$(openssl rand -hex 24)|; s|^JWT_SECRET_KEY=.*|JWT_SECRET_KEY=$(openssl rand -base64 48 | tr -d '\n')|" .env && rm .env.bak
   docker compose up --build

2. 2

   Open the app

   When containers are healthy, open the UI in your browser:

   http://localhost:8151

3. 3

   Sign up and log in

   When the login screen appears, click 新規登録 (Sign up) at the bottom — do not try to log in yet if you have no account.

   

   On the registration screen, fill in these fields, then click 新規登録:

   • ユーザー名 — at least 1 character; any letters including Japanese; must be unique
   • メールアドレス — a valid address (e.g. you@example.com)
   • パスワード — at least 8 characters; half-width letters, numbers, and symbols

   

   When registration succeeds, you are signed in automatically and land on 自分のチケット (My tickets) — no separate login needed.

4. 4

   Create a Team

   You need a team before creating tickets. The post-login 自分のチケット screen shows a “SENN をはじめましょう” (Get started) panel — you can create the team right from there.

   Click the ＋ next to チーム (Teams) in the left sidebar (or click 最初のチームを作成 — same result).

   The 新規チーム作成 (New team) dialog opens.

   Fill in the fields below and click 作成 (Create).

   • チーム名 — required; any name is fine
   • チーム Prefix — optional. The start of ticket keys (e.g. SMP → SMP-000001). If blank, TEAM is used
   • Description, icon, color, and notification webhook are optional (editable later)

   After creation, the team appears under “チーム” in the sidebar.

5. 5

   Create your first ticket

   On the screen right after creating the team, click チケットを作成 (Create ticket).

   The チーム (Team) field already has your new team selected.

   Type a タイトル (title) and click チケット作成 (Create ticket).

   • タイトル — required
   • 説明 — optional
   • Assignee, priority, due date, and other fields are optional (editable later)

   Open チケット (Tickets) in the sidebar to see the new ticket in the list. That completes the first end-to-end flow.

Detailed setup guide with screenshots (Japanese) →