How to Change Project Settings

Learn how to manage and modify your project settings on Zenifra.

Accessing Settings

1. In the sidebar, click Projects
2. Find and click on the project name you want to edit
3. On the project page, click the "Edit" button in the top right corner

Available Settings

Project Name

The project name can be changed at any time.

Rules:

• Minimum: 6 characters
• Maximum: 32 characters
• Only lowercase letters, numbers, and hyphens

Note: Changing the name does not affect the existing subdomain.

Project Description

The project description can be changed at any time.

Characteristics:

• Optional field to describe the project purpose
• Helps identify and organize your projects
• Can include information such as technology used, client, or purpose

Project Image

The OCI image used by the project can be updated.

How to update:

1. In the image section, enter the new image in the format:

   docker.io/nginx:1.26-alpine3.19
   docker.io/postgres:17.5-alpine3.21

Limitations:

• Cannot change the image authentication type (public/private)
• Private image must remain private
• Public image must remain public

Tip: To automatically update the image via GitHub Actions, check our automatic deployment tutorial.

Environment Variables (ENVs)

Environment variables can be added, edited, or removed.

Characteristics:

• Limit of 50 ENVs per project
• Instances are automatically restarted when changing ENVs
• Use ENVs for sensitive configurations like API keys and database passwords

ENV examples:

DATABASE_URL=postgres://user:pass@host:5432/db
API_KEY=your-api-key-here
NODE_ENV=production

Whitelist (Allow List)

The whitelist defines which IP addresses can access the project.

Characteristics:

• Non-listed IPs will be blocked
• CIDR format: 192.168.1.0/24 or 10.0.0.1/32
• Maximum of 10 entries in the whitelist

How to add your IP: Click "Add Current IP" to automatically include your IP address.

CIDR format:

• 0.0.0.0/0 - Allows all IPs
• XXX.XXX.XXX.XXX/32 - Specific IP
• XXX.XXX.XXX.XXX/YY - IP block

Note: Changing the whitelist does not restart instances.

Blacklist (Block List)

The blacklist defines IPs that will be blocked even if they are on the whitelist.

Characteristics:

• Blocked IPs will not have access to the project
• Useful for blocking malicious IPs
• Maximum of 10 entries in the blacklist

Note: Changing the blacklist does not restart instances.

Number of Instances

You can increase or decrease the number of project instances.

Limits:

• Minimum: 1 instance
• Maximum: 10 instances

To increase the limit: Contact support if you need more than 10 instances.

Impact:

• More instances = greater processing capacity
• More instances = higher cost
• Traffic is distributed among instances

Project Actions

Stop the Project

When stopping the project:

• Instances are stopped
• Ephemeral storage is deleted
• The project cannot be accessed
• For hourly projects, billing is stopped

When to use:

• When you don't need the application temporarily
• To save costs on hourly projects

Start the Project

To start a stopped project:

• Instances are started again
• Ephemeral storage is recreated
• The project becomes accessible again
• Billing resumes (for hourly projects)

Cancel Plan

Only for monthly or annual contract projects

When canceling the plan:

• There will be no charge on the next invoice
• The project will be maintained until the end of the contract period
• After expiration, the project will be removed

Note: For hourly payment projects, this option is not available. Use "Stop Project" to interrupt billing.

Delete the Project

Deletion is permanent and irreversible.

What happens:

• All instances are removed
• All data is deleted
• Storage is freed
• API Keys are revoked

Requirements:

• The project cannot have an active plan
• For contracts, wait for expiration

Next Steps

• Project Metrics and Insights
• How to Create a Project
• Payment Settings

FAQ

Can I change the project plan?

Yes. If the payment model is hourly, you can change the plan at any time. For monthly or yearly contracts, changes are only allowed at the end of the contract period.

Does changing ENVs cause downtime?

Yes. Instances are restarted to apply new environment variables. Plan changes during low-traffic hours.

Can I restore a deleted project?

No. Deletion is permanent. Make sure to backup your data before deleting.

Why can't I increase instances?

The maximum limit is 10 instances. To increase, contact support.

What happens to data when stopping the project?

• Persistent data: Kept
• Ephemeral data: Deleted

We recommend using persistent storage for important data.