nexo-books

```bash
cp .env.example .env
# Edit .env: set MSSQL_SA_PASSWORD to a strong password (16+ chars, upper, lower, digit, symbol)
docker compose up -d --build
# Open http://localhost:8080
# First sign-in: use any email, enter the code from the log
docker compose logs -f web
```

```bash
# Install .NET 10 SDK
wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh --channel 10.0

# Install SQL Server 2019 or 2022
curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
sudo add-apt-repository "$(wget -qO- https://packages.microsoft.com/config/ubuntu/22.04/mssql-server-2022.list)"
sudo apt-get update
sudo apt-get install -y mssql-server
sudo /opt/mssql/bin/mssql-conf setup

# Clone and build
git clone <repo-url> nexo-books
cd nexo-books/src/Nexo.Web
npm run setup
dotnet publish -c Release -o /var/www/nexo

# Configure appsettings.Production.json with connection strings
sudo nano /var/www/nexo/appsettings.Production.json

# Run migrations
cd /var/www/nexo
dotnet Nexo.Web.dll -- migrate

# Set up systemd service
sudo nano /etc/systemd/system/nexo.service
# [Unit]
# Description=Nexo-Books
# [Service]
# WorkingDirectory=/var/www/nexo
# ExecStart=/root/.dotnet/dotnet /var/www/nexo/Nexo.Web.dll
# Restart=always
# [Install]
# WantedBy=multi-user.target

sudo systemctl enable nexo
sudo systemctl start nexo

# Install nginx as reverse proxy
sudo apt-get install -y nginx
sudo nano /etc/nginx/sites-available/nexo
# server {
#   listen 80;
#   server_name your-domain.com;
#   location / {
#     proxy_pass http://localhost:57363;
#     proxy_http_version 1.1;
#     proxy_set_header Upgrade $http_upgrade;
#     proxy_set_header Connection keep-alive;
#     proxy_set_header Host $host;
#     proxy_cache_bypass $http_upgrade;
#   }
# }
sudo ln -s /etc/nginx/sites-available/nexo /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

# Install SSL with certbot
sudo apt-get install -y certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com
```

```bash
# Create resource group
az group create --name nexo-rg --location eastus

# Create Azure SQL server and database
az sql server create --name nexo-sql --resource-group nexo-rg --location eastus --admin-user sqladmin --admin-password <strong-password>
az sql db create --resource-group nexo-rg --server nexo-sql --name NexoBooks_Master --service-objective S1
az sql server firewall-rule create --resource-group nexo-rg --server nexo-sql --name AllowAzure --start-ip-address 0.0.0.0 --end-ip-address 0.0.0.0

# Create App Service plan and web app
az appservice plan create --name nexo-plan --resource-group nexo-rg --sku B2 --is-linux
az webapp create --resource-group nexo-rg --plan nexo-plan --name nexo-books --runtime "DOTNETCORE:10.0"

# Configure connection strings
az webapp config connection-string set --resource-group nexo-rg --name nexo-books --connection-string-type SQLAzure --settings Nexo__MasterConnectionString="Server=nexo-sql.database.windows.net;Database=NexoBooks_Master;User Id=sqladmin;Password=<password>;" Nexo__Servers__default="Server=nexo-sql.database.windows.net;Database=master;User Id=sqladmin;Password=<password>;"

# Deploy
cd src/Nexo.Web
npm run setup
dotnet publish -c Release -o ./publish
cd publish
zip -r ../deploy.zip .
az webapp deployment source config-zip --resource-group nexo-rg --name nexo-books --src ../deploy.zip

# Run migrations
az webapp ssh --resource-group nexo-rg --name nexo-books
dotnet Nexo.Web.dll -- migrate
```

```bash
# Ensure Docker Desktop is running
cp .env.example .env
# Edit .env in Claude Code: set MSSQL_SA_PASSWORD
docker compose up -d
# Wait 30 seconds for SQL Server to initialize
docker compose logs -f web
# Open http://localhost:8080 in your browser
# Sign in with any email; the 6-digit code appears in the logs above
```