Producing a reliable, customized project is a core function of the ActiveState Platform. This guide shows you how to create projects that include only the languages and artifacts (packages, bundles, patches, etc.) you need for the specific operating system(s) you are working on.

You can create projects using either the web interface or the State Tool CLI.

Create a Project via Web Interface

To create a new project from scratch using the web interface:

1. Sign in to your ActiveState Platform account.
2. Go to your organization’s Dashboard tab.
3. Click the New Project button.
4. Select the organization you want to create the project in.
5. Select a language and version for your project.
6. Choose one or more operating systems from the list provided. The option to select more than one operating system is restricted to paid tiers.
   • If you are using Linux, be sure to choose a compatible glibc for your operating system.
7. Choose your project access setting. Only paid tiers can make projects Private.
8. Enter a unique project name or use the default name provided. The project name will act as its default URL.
9. Choose to add packages now by clicking Add Packages, or click Finish and Install to move straight to downloading your project. If you add packages now:
   • Search for individual packages and versions required for your project by entering the name of the package or bundle you need and clicking Add.
   • Import packages from a file by clicking the link on the right. For more information on specifying your project requirements using a file, see Import and manage requirements.
10. Click Close to return to your Project page with a notice to save your changes.
11. If you made changes, click Save to commit your selection(s) to your project and begin the build process.
12. Wait for the project to build. Build status can be seen from the Deploy tab.
13. To use the project, go to the Overview tab of your project and follow the instructions to install and use your runtime.

After installing the State Tool, you can create a new ActiveState project directly from your command line by running:

state init <orgname>/<projectname> --language <language@version>

For example state init myOrg/python3.10 --language python@3.10

Your new project will automatically sync with your Platform account.

To access private projects in an organization, the State Tool must be authenticated against the ActiveState Platform by entering state auth and following the prompts.

Create a Project from an SBOM

This feature is for paid customers and is available upon request. Contact support to request this feature at support@activestate.com.

A software bill of materials (SBOM) declares the inventory of components used to build a software artifact, including any open source and proprietary software components. An SBOM allows development teams to make sure open-source and third-party software components are up to date and respond quickly to new vulnerabilities. Buyers and other stakeholders can use an SBOM to perform vulnerability or license analysis, which can be used to evaluate and manage risk in a product.

ActiveState projects can be created from a compatible SBOM. SBOMs can be generated by ActiveState or through third-party services like Snyk, Trivy, Syft, and others.

Create a project from an SBOM using the web UI

1. Confirm you have an SBOM of a supported file type. See supported formats.
2. Sign in to the ActiveState Platform.
3. At the top of the page, select the organization where the new project should be created.
4. Click Upload SBOM.
5. Click Select file to upload and select your file.
6. Choose a name your project. By default, the file name of the ingested SBOM will be used as the project name.
7. Select your project access setting (Public or Private project).
8. Click Create project.
9. Review your SBOM analysis. In this read-only mode, you can view the full list of components and vulnerabilities in your project.
   • If you encounter solver errors, you can select “Set all to auto” and make adjustments later in the Configuration tab.
   • Missing packages will appear in Unavailable Packages.
10. To make the project editable, click Fix Vulnerabilities and then Convert to Runtime.

Import a Project from GitHub

You can import the dependencies needed for your existing GitHub project directly from a requirements file in the root folder of your GitHub repository. At this time, we only support Python, Perl, and Ruby projects.

This feature is only available to users who have linked a GitHub SSO to their ActiveState account. For more information, see create an account.

To import an existing GitHub project:

1. Sign in to the ActiveState Platform.
2. Go to your organization’s Dashboard tab.
3. Click the +New Project button.
4. Click the Scan a Repository button.
5. Select your repository by using the search bar, clicking the correct repo from the list shown, or entering the repository URL in the field provided.
6. Click Scan Repo.
7. After receiving an “Import Status Success” message, click Continue to continue building your runtime.
8. Select a language version, operating system, and set the visibility of your project to Public or Private.
9. Click Create Project to return to your project Configuration page.

If your GitHub integration does not succeed, verify that your requirements file name in the root folder of your repo matches one of the following:

• Python projects: requirements.txt, Pipfile.lock, pyproject.toml, poetry.lock, or any Pipfile
• Perl projects: META.json or any cpanfile
• Ruby projects: Gemfile.lock

Next Steps

After creating your project:

1. Deploy it locally - Get your project running on your machine
2. Manage packages - Add and update dependencies
3. Share with others - Collaborate with team members
4. Move or organize projects - Manage multiple projects