Dev Setup. Outline setup

dev_setup.md

Dev Tools

Package Managers

• brew Mac package manager

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• Mise dev tools manager

  • Alternative to node, python, cmake etc

• SDK Manager For Java and JVM related pacakages

sdk list java
sdk install java 21.0.5-amzn
sdk use default java 21.0.5-amzn

• uv python package manager (pip alternative)

Terminal

• iterm2 - Terminal for Mac

• Oh My Zsh

• Vim Dot Files

• Curl & Wget

brew update
brew upgrade --all

brew install wget curl

• git - Git cli & GUI tools

brew install git
brew install git-gui
brew install git-flow

Git alias config

~/dev ❯ cat ~/.gitconfig
[alias]
	st = status
	br = branch
	co = checkout
	unstage = reset HEAD --
	lg1 = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(auto)%d%C(reset)' --all
	lg2 = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold cyan)%aD%C(reset) %C(bold green)(%ar)%C(reset)%C(auto)%d%C(reset)%n''          %C(white)%s%C(reset) %C(dim white)- %an%C(reset)'
	lg = lg1

Docker

• Docker Desktop - For running containers in Mac
• Minikube

brew install minikube

Text Editors & Other tools

• Sublime text
  • Install package manager & top 10 packages
  • Sublime Spacegray theme
• Flycut Clipboard Manager
• Redis GUI

brew install --cask another-redis-desktop-manager

• Sequel Ace Database browser

brew install --cask sequel-ace

• Run PgAdmin in docker container

docker run --rm --name pgadmin-container -p 5050:80 -e [email protected] -e PGADMIN_DEFAULT_PASSWORD=catsarecool -d dpage/pgadmin4

• [Visual VM] (https://visualvm.github.io/index.html)
  • brew install --cask visualvm

outline-docker-compose.yml

services:
  outline:
    image: docker.getoutline.com/outlinewiki/outline:latest
    env_file: ./docker.env
    ports:
      - "8443:80"
    volumes:
      - storage-data:/var/lib/outline/data
    depends_on:
      - postgres
      - redis

  redis:
    image: redis
    env_file: ./docker.env
    volumes:
      - ./redis.conf:/redis.conf
    command: ["redis-server", "/redis.conf"]
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 30s
      retries: 3

  postgres:
    image: postgres
    env_file: ./docker.env
    volumes:
      - database-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD", "pg_isready", "-d", "outline", "-U", "user"]
      interval: 30s
      timeout: 20s
      retries: 3
    environment:
      POSTGRES_USER: 'user'
      POSTGRES_PASSWORD: 'pass'
      POSTGRES_DB: 'outline'

volumes:
  storage-data:
  database-data:

outline-docker.env

POSTGRES_USER=postgres
POSTGRES_PASSWORD=password
POSTGRES_DB=outline
SECRET_KEY=144586b36985e7806d39ee6f0c3ed52f1c96b156551fb15403844d3e90f6fe4f
UTILS_SECRET=858a65b1f2618bd26677a7a8de2652cfa093a86d6bc05d2776366d155f518b22
URL=https://outline.not-out.xyz

PGSSLMODE=disable
DATABASE_URL="postgres://postgres:password@postgres:5432/outline"
REDIS_URL=redis://redis:6379
FILE_STORAGE=local
FILE_STORAGE_LOCAL_ROOT_DIR=/var/lib/outline/data
FILE_STORAGE_UPLOAD_MAX_SIZE=26214400

FORCE_HTTPS=false

PORT=80

GOOGLE_CLIENT_ID=<google_ID>
GOOGLE_CLIENT_SECRET=<google_secret>