----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Releases

A release represents a specific version of your deployment within a channel. Each release has a unique name and URL, allowing you to manage multiple versions of your application.

Release Concepts

• Default Release

  • Every channel has a default release named latest
  • The latest release name is omitted from URLs

• Named Releases

  • Custom names for specific versions
  • Useful for feature branches or pull requests
  • Appear in the deployment URL

URL Structure

Release URLs follow this pattern:

https://<project>-<channel>-<org>-<release>.january.sh

Examples:

https://api-dev-acme.january.sh         # Latest release (default)
https://api-dev-acme-clientwinter.january.sh      # Named release
https://api-preview-acme-pr123.january.sh  # PR preview

Important

When using the defaultlatest release, the release name is omitted from the URL.

Managing Releases

Creating Releases

A release is created when you deploy your project.

npx serverize deploy -p <project> -c <channel> -r <release-name>

Optional parameters:

• -c <channel>: Target channel (default: dev)
• -r <release-name>: Release name (default: latest)

List Releases

npx serverize releases list -p <project> -c <channel>

Terminate Releases

npx serverize releases terminate -p <project> -c <channel> -r <release-name>

Auto-Termination

# Release will terminate after 1 hour
npx serverize deploy -p backend-api -c preview -r test --terminate-after 1h

• Manage releases with the CLI
• Learn about CI/CD Integration
• Configure Preview Deployments
• Explore Secrets Management