Forgejo by VSHN

Forgejo, managed by VSHN, for you.

Forgejo is a self-hosted lightweight software forge. Easy to install and low maintenance, it just does the job.

— Forgejo Website

Our service offers a compelling solution for businesses seeking secure and efficient code hosting. Based in Switzerland, our service provides several key advantages:

Switzerland Based

Hosting your Forgejo service by a company based in Switzerland ensures data privacy, security, and compliance with strict Swiss regulations.

Unrestricted Access to Forgejo Features

With our service, you have access to the full range of Forgejo’s features, ensuring you can tailor your code hosting needs to your specific needs.

Simple Price Model

We offer a straightforward pricing model, making it easy for you to budget and plan for your code hosting needs without hidden costs or surprises.

SLA Available

For added peace of mind, we offer Service Level Agreements (SLAs) that guarantee the reliability and availability of your Forgejo service.

Run by Experts Running Software

Our service is managed by a team of experts with a proven track record of running complex software systems, ensuring that your Forgejo service is in capable hands.

In summary, our service provides a secure, feature-rich, and hassle-free solution for code hosting, all while benefiting from Switzerland’s robust data protection laws and the expertise of DevOps professionals.

The user documentation is available under docs.appcat.ch.
Availability of the service

Features

No downtime during regular maintenance

[1]

High availability

Infinite [2] Users, Repositories and Organisations

Admin user access (via admin web console)

Forgejo Actions runner

Database: PostgreSQL by VSHN

TLS encrypted database connection

Custom subdomain

Guaranteed performance

[3]

Forgejo specific metrics and dashboards

Support

The following common features are available as well:

Self-Service Instance Provisioning and Configuration

Service instances can be self-service ordered and are provisioned fully automated in the background. Access to self-service provisioning is provided via custom Kubernetes configuration objects in the Kubernetes cluster or via Open Service Broker API (on request).

Best-Practice Configuration Management

Services are configured with best practices and the configuration is updated continuously as we learn improvements during day-2 operations and from the community. Industry standards are used for security configuration and wherever possible TLS encrypted connections are offered by default.

Maintenance and Security Operations

Patch updates are applied as they get available. We monitor security information for services and apply zero-day patches or workaround configuration as they become available.

Data Protection and Recovery

All services offer a regular backup option. See the service descriptions for more details.

Service Metrics

Performance metrics are collected regularly and are available as graphs to the user. The metrics are automatically monitored and acted upon irregularities, see Monitoring and Alerting below.

Monitoring and Alerting

Service Level Indicators are monitored and alerted upon. Depending on the service level alerts are automatically handled by a VSHNeer.

Service Logging

All logs are collected and are available to debug service errors.

Support by VSHN or Vendor

Support for all services are available from VSHN support engineers. Depending on the service, additional support by the software vendor or a third-party might be available.

Forgejo Support

Support for Forgejo is organized in three levels:

Level 1: End-User Support

Helping users with the daily use of Forgejo is the customer’s concern. End-user support isn’t included in this service.

Level 2: Operations Support

VSHN provides support concerning the operations of Forgejo and the database. Our Support Plans describes in detail what VSHN offers in terms of support.

Level 3: Application Support

The Forgejo community provides support on a best-effort basis on their Matrix chat channel.

Supported versions

We only support the latest Forgejo version.

Service Level Indicator (SLI)

According to the service levels the SLI "Up" is defined as follows:

Forgejo responds to HTTP requests to the authentication page. The service is considered up, if the request succeeds in under 5 seconds.

Data Protection

All persistent data of Forgejo is stored in a PostgreSQL database and on the filesystem. See Data Protection in the PostgreSQL product description for more details about the database backups.

Data stored on the filesystem is kept secure using K8up.

Recurring Maintenance

We conduct recurring maintenance tasks on the service to keep it stable and up-to-date.

Planned Maintenance Activities
  • Updating of the base container image with the latest patched version, this causes a service restart.

  • If there’s a newer minor version available that does not contain breaking changes, then the service will automatically be updated to that minor version.

  • Major upgrades are not automatic.

  • Configuration improvements as we learn new best-practices or some configuration proved to be non-optimal.

Mandatory Maintenance Activities
  • Security issue (CVE) mitigation by updating to a patched version or configuration adjustments, usually causes service restart.

  • Regular maintenance on the underlying platform, usually causing up to 2 restarts per replica.

Maintenance Windows

This is an automated recurrence once a week. The day and time can be configured per service instance, whereas by default it is a random time in the night from Tuesday to Wednesday.

Users responsibilities

As a DevOps company, we believe in its collaborative approach. Flawless service is only possible through a sense of responsibility on both sides. Accordingly, we rely on the user to consider the following points:

  • Choose reasonably sized resources for the software consuming the service

  • Act early when an increase in service usage is foreseen (for example increase resources)

  • Rely on best-practices for using the service

  • Choose a matching service level for your use-case

Pricing

Service Level per 30 days (720h)

CHF 40.00

CHF 120.00

  • Excl. compute resources.

  • Incl. PostgreSQL by VSHN as database backend.

  • These prices are valid starting 2024-07-01 until further notice.

See Pricing for more details.

Addon: Forgejo Runner

A Forgejo runner executes CI/CD actions based on Forgejo actions.

This addon is available on request, as it depends on many factors, especially the requirements of the type of actions to be executed.

Service Maturity

This section describes the maturity of this service. We are constantly improving it and adding more features to the service.

Provisioning

Backup and Restore

Logs

Metrics

Alerting

Automated Maintenance

Version Upgrades

Scaling

FAQ

What do I need to get the service?

Currently the service is available on APPUiO and Managed OpenShift. Once you have access to such a cluster, it’s a matter of creating a Kubernetes object to order a service instance. In the getting started guide you’ll find all the information you need to get started.

Where do I get it?

As mentioned in the previous answer, the service is available on APPUiO and Managed OpenShift.

Are there any extra costs?

Yes, there are usage costs associated with the service. Please refer to VSHN AppCat Services Pricing for further information.

Who will set it up?

All services are available in full self-service. There is no need to open a ticket and wait until the service is provisioned, it’s available immediately.

What do I need to do?

The user documentation explains everything you need to know.

Can I get it myself or do I need to contact anyone?

There is no need to contact anyone, just follow the instructions on docs.appcat.ch and you’ll be up and running in no time.

How can it be integrated in my environment?

Services are available right now on APPUiO and Managed OpenShift. If you want these services on your environment, please contact us and we’ll help you get started.

How can I get support?

You can either open a ticket on our customer portal or send an email to support@vshn.ch. Please note that support is only available with our support plans.

What is the difference to Codey?

Our Codey service is a full self-service SaaS offering, which includes the compute resources. It’s "batteries included", you cannot choose on which OpenShift or Kubernetes cluster Codey runs, whereas with the "Forgejo by VSHN" application catalog service, you can have it running on your own cluster. You also have more configuration options with the application catalog service and are not tied to the Codey plans.


1. With more than 1 replica, excluding version upgrade
2. As many as Forgejo supports
3. Depends on the underlying platform