Skip to main content


Push local code to the platform, or create a new actor on the console and integrate it with a Git repo to optionally automatically rebuild any new changes.

Once you've actorified your code, there are two ways to deploy it to the Apify platform. You can either push the code directly from your local machine onto the platform, or you can create a blank actor in the web interface, and then integrate its source code with a GitHub repository.

With a Git repository

Before we deploy our project onto the Apify platform, let's ensure that we've pushed the changes we made in the last 3 lessons into our remote GitHub repository.

The benefit of using this method is that any time you push to the Git repo, the code on the platform is also updated and the actor is automatically rebuilt. Also, you don't have to use a GitHub repository - you can use GitLab or any other service you'd like.

Creating the actor

Before anything can be integrated, we've gotta create a new actor. Luckily, this is super easy to do. Let's head over to our Apify Console and click on the New button, then select the Empty template.

Create new button

Easy peasy!

Changing source code location

In the Source tab on the new actor's page, we'll click the dropdown menu under Source code and select Git repository. By default, this is set to Web IDE.

Select source code location

Now we'll paste the link to our GitHub repository into the Git URL text field and click Save.

Adding the webhook to the repository

The final step is to click on API in the top right corner of our actor's page:

API button

And scroll through all of the links until we find the Build Actor API endpoint. Now we'll copy this endpoint's URL, head back over to our GitHub repository and navigate to Settings > Webhooks > Add webhook. The final thing to do is to paste the URL and save the webhook.

Adding a webhook to your GitHub repo

That's it! The Actor should now pull its source code from the repo and automatically build.

Without a GitHub repository (using the Apify CLI)

If you don't yet have the Apify CLI, learn how to install it and log in by following along with this brief lesson about it.

If you're logged in to the Apify CLI, the apify push command can be used to push the code straight onto the Apify platform from your local machine (no GitHub repository required), where it will automatically be built for you. Prior to running this command, make sure that you have an .actor/actor.json file at the root of the project. If you don't already have one, you can use apify init . to automatically generate one for you.

One important thing to note is that you can use a .gitignore file to exclude files from being pushed. When you use apify push without a .gitignore, the full folder contents will be pushed, meaning that even the storage and node_modules will be pushed. These files are unnecessary to push, as they are both generated on the platform.

The apify push command should only really be used for quickly pushing and testing actors on the platform during development. If you are ready to make your actor public, use a Git repository instead, as you will reap the benefits of using Git and others will be able to contribute to the project.


Great! Once you've pushed your actor to the platform, you should see it in the list of actors under the Actors tab. If you used apify push, you'll have access to the multifile editor (discussed here).

Deployed actor on the Apify platform

The next step is to test your actor and experiment with the vast amount of features the platform has to offer.

Wrap up

That's it! In this short section, you've learned how to take your code written in any programming language and turn it into a usable Actor that can run on the Apify platform! The next step is to start looking into the paid Actors program, which allows you to monetize your work.