Appfarm Documentation
Getting startedDocumentationCommunityAppfarm Create
  • Overview
  • Getting Started
    • What is Appfarm?
    • Key concepts
    • Quickstart
      • Speed intro
      • Step-by-step guide
    • Appfarm Showroom
    • FAQ
  • Appcademy
    • Learning paths
    • Appfarm Fundamentals
      • Intro Course
        • 1. Intro to No-Code and Appfarm
        • 2. Navigation in Appfarm Create
        • 3. What is Apps?
        • 4. Intro to UI Editor
        • 5. Data Model
        • 6. App Data
        • 7. Actions
        • 8. Tips and Tricks
        • 9. Intro to practical walkthrough
        • 10. Create a details view of a Project
        • 11. Create a Custom List
        • 12. Swipe and Delete
        • 13. Functionality for simple Create of Data
        • 14. Upload and Download Photos
        • 15. Input Dialog with Validation and Save
        • 16. Dashboard
        • 17. Summary
        • Quiz
      • User Interface Fundamentals
        • Container - Sectioning, Styling and Repeating
        • Conditional Styles
        • Motions
        • Responsive Design
        • Step-by-step workflow
        • Featured UI Components
        • Quiz
      • App Data Fundamentals
        • Data Source Filtering
        • App Variables and Runtime Properties
        • URL Parameters
        • Quiz
      • Actions & Logic Fundamentals
        • Event Handlers
        • Featured Action Nodes
        • Context Parameters
        • Quiz
      • Services Fundamentals
        • Introduction to Services
        • Setting up a Service
        • Scheduling a Service
      • Integration Fundamentals
        • The web request action node
        • Fetch data from an endpoint
        • Map data to a data source
        • Modify the response
        • Nested data mapping
        • Path parameters
        • Authentication
        • Send data to an endpoint
        • Quiz
      • User handling and permissions
        • Users and roles
        • Permissions
        • Creating users
        • Extending the User object class
        • Updating and deleting users
        • Unauthenticated access
        • Quiz
    • Appfarm Professional
      • User Interfaces
        • Featured UI Components
        • Concepts and Use Cases
      • Data Structures & Data Handling
        • Data Features
        • Search & Filters
        • Featured Action Nodes
        • GraphQL
      • Logic & Flow
        • Logical Concepts
        • Date and Time Handling
        • Featured Action Nodes
        • Exception Handling
      • Login & Configuration
        • Login and Authentication
        • Settings, Configuration and Languages
      • Security & Operations
        • Security and Permissions
        • Deployment
        • Schedules and Logs
        • Debugging and App Health
      • Performance & Optimization
        • Optimizing Performance
        • Enhancing Functionality
    • Appfarm Sales Representative
    • Appfarm Developer Forum
      • Session 1: Data Modeling in Appfarm Create
      • Session 2: App Data in Appfarm Create
      • Session 3: Services in Appfarm Create
      • Session 4: Optimizing Performance
    • Background
      • Databases
        • Data modeling 101
        • Database normalization
  • Library
    • UI components
      • Advanced bar chart
      • Advanced bubble chart
      • Advanced combined chart
      • Advanced gantt chart
      • Advanced heatmap chart
      • Advanced line/area chart
      • Advanced pie chart
      • Advanced scatter plot chart
      • Advanced solid gauge chart
      • Animated component
      • Avatar
      • Avatar group
      • Basic bar chart
      • Basic gauge chart
      • Basic line chart
      • Basic pie chart
      • Bottom navigation
      • Button
      • Checkbox
      • Chip group
      • Circular progress
      • Coded component
      • Container
      • Date & time picker
      • Drawable canvas
      • Floating action button
      • Icon
      • Icon button
      • Iframe
      • Image
      • Linear progress
      • List
      • Map
      • Menu list
      • Multi select
      • PDF reader
      • Popover
      • Radio buttons
      • Rich text editor
      • Rich text
      • Select
      • Slider
      • Speed dial
      • Switch
      • Table
      • Tabs
      • Text
      • Text edit
      • View container
      • Visibility group
    • Action nodes
      • Aggregate data
      • Advanced search
      • Auth operations
      • Block
      • Catch exception
      • Copy to clipboard
      • Create file archive
      • Create file object
      • Create object
      • Create user account
      • Delete objects
      • Delete user account
      • Duplicate objects
      • End execution
      • Exit block
      • Exit loop
      • Export data
      • Foreach
      • Generate document
      • If
      • Import data
      • Invalidate cache
      • Log in
      • Log to console
      • Log out
      • Next iteration
      • Navigate
      • Open/close popover
      • Open confirm dialog
      • Open print dialog
      • Open snackbar
      • Open Unsplash dialog
      • Open URL
      • Persist objects
      • Push notifications
      • Read objects
      • Request permissions
      • Run code
      • Run other action
      • Run service
      • Scan barcode/QR code
      • Send email
      • Send SMS
      • Set client language
      • Set data source attributes
      • Set selection
      • Set theme
      • Set user account image
      • Show install app prompt
      • Sleep
      • Sort objects
      • Throw exception
      • Toggle drawer
      • Update object
      • Update secret
      • Update user account
      • Web request
      • While
  • Reference
    • Appfarm Create
      • Appfarm Commander
      • Blue dots
      • Copy & Paste
      • Farmer's Market
      • Find references
      • Find usage
      • Keyboard shortcuts
      • Undo/Redo
      • User preferences
    • Platform concepts
      • Conditions
      • Data bindings
      • Date and time
      • Event handlers
      • Filters
      • Functions
      • Markdown
      • Objects
      • Operators
      • Value processor
    • Dashboard
    • Apps
      • UI
        • Views
          • Dialog
          • Drawer
        • Layout designer
        • Component properties
        • Shareable UI components
      • Data
        • App variables
        • Data sources
        • Calendar data sources
      • Actions
      • App settings
      • App size
      • App health
    • Services
      • Service Endpoints
      • Service settings
      • Service health
      • API explorer
    • Data model
      • Object classes
      • Object class properties
      • Enumerated types
      • GraphQL
        • Queries
        • Mutations
      • Data Extract API
      • Time series data
    • Operations
      • Deploy
      • Schedules
      • Logs
    • Resources
      • Themes
      • Files
      • Fonts
      • Internationalization
    • Configuration
      • Environments
      • Login
        • Custom auth providers
    • Security
      • Users
      • Service accounts
      • Roles
      • Secrets
      • Permissions
        • Conditional Permissions
    • Appfarm Client
      • Developer tools for Apps
      • Developer tools for Services
      • Warnings and errors
  • How to
    • Data modeling
      • Many-to-many relationships
      • Use naming conventions
      • Offline data handling
      • Data silos and White labelling
    • User interface
      • Manage a many-to-many relationship with a Chip group
      • Configure drag and drop
      • Build a drag-and-drop calendar
      • Design a responsive layout
      • Work with flexbox
      • Use Mapbox as a map layer
      • Understand charts
    • Logic and flow
      • Event Log Design
      • Configure advanced search
    • Themes and styling
      • Change the active theme
      • Add custom email templates
    • Enhance your app
      • Add deep links
      • Add keyboard shortcuts
      • Add link previews for social media
      • Apply SEO best practices
      • Change the active language
      • Generate a PDF from a Container
    • Integrations
      • Integrate with external systems
      • Integrate with OpenAI
      • Integrate with Google Analytics (GA4)
      • Configure a custom email account
      • Integrate with a payment provider
      • Integrate with Signicat
      • Integrate directly with an external database
      • Retrieve a Bearer token from Google Cloud
      • Fetch data from BigQuery
      • Retrieve access token from Microsoft Entra ID
    • Workflow automation
      • Update an OAuth 2.0 access token from a service
    • Authentication and access control
      • Add users and assign roles
      • Configure unauthenticated access
      • Implement third-party authentication
    • Security, testing and deployment
      • Add a custom domain
      • Install an app on a device
      • Get ready for Production
      • Optimize performance
      • Security checklist
      • Test and debug
    • Example apps
      • Create an Instagram clone
        • The end result
        • Designing the feed
        • Create new post
        • Add a like-button
        • Add comment-functionality
  • Solution administration
    • Subscription and billing
    • Dedicated tier benefits
    • Guide to GDPR
      • Key principles
      • How Appfarm protects personal data
      • How you can protect your clients’ data
      • Glossary
    • Appfarm and the EU AI Act
  • Policies
    • Appfarm Policies
    • Data Processors
    • Privacy Policy
Powered by GitBook
On this page
  • Environments
  • Deploy dialog
  • Deploy changelog
  • Appfarm Upgrade
  • Snapshots
  • Rollback to a snapshot
  • Rollback a deploy

Was this helpful?

Export as PDF
  1. Reference
  2. Operations

Deploy

Deploy your apps and services to Test, Staging and Production. View the Solution deploy history, and manage Snapshots.

PreviousOperationsNextSchedules

Last updated 1 month ago

Was this helpful?

Appfarm Create has one-click deploy, so that you can push your apps and services to Production with one click of the big blue button. Deploys to the Development environment are instant and the will hot reload by default. You can also revert deployed changes through the use of and .

Environments

Up to four deployment environments are available. The environments available in your Solution depend on your subscription agreement. The environments are:

Environment
Root URL
Description

Development

https://{SOLUTION_SHORTNAME}-dev.appfarm.app

Instant deploys and with its own database. For Appfarm developers only.

Test

https://{SOLUTION_SHORTNAME}-test.appfarm.app

A sandbox for non-developers to test in, with its own database.

Staging

https://{SOLUTION_SHORTNAME}-stage.appfarm.app

A final testing ground before Production. Uses the Production database.

Production

https://{SOLUTION_SHORTNAME}.appfarm.app

The live environment for your end-users.

Important

  • The Staging environment uses the Production database. Any changes made to data in Staging will be reflected in Production.

Deploy dialog

The big blue deploy button will be active if there are changes to be deployed from one environment to the next. Click this button to open the Deploy dialog. If the deploy button is disabled, there are no changes to deploy.

Solution deploy

Solution deploys are sequential across environments, so you must first deploy to Test and Staging (if they are active in your solution) before deploying to Production. All changes in a given environment are deployed to the next.

The solution deploy dialog is shown in the image below.

  1. Select when to deploy. By choosing Other, a specific time can be set.

  2. Optionally provide a custom deploy message to show users alongside the default deploy message. The default deploy message is: "New version available A new version of {APP NAME} is ready. Please press reload to get the new version."

  3. Optionally include your avatar and name with the deploy message to give it a more personal touch.

  4. Optionally, you can provide an internal note to display in Appfarm Create's deploy history. This is useful for tracking changes across deployments.

  5. Click to deploy changes and platform upgrades to the next environment.

Targeted deploy

Tier-based access

Your subscription tier determines the availability of targeted deploy. Please check your current subscription or contact customer success to ensure you have access to this functionality.

Targeted deploy allows developers to deploy selected changes directly to selected environments. For instance, a change can be deployed directly to Production without interrupting ongoing testing in the Test environment. Four types of deployable "units" can be deployed independently of other changes in the environment:

  • Apps

  • Themes

  • Schedules

  • Services

Appfarm Create automatically calculates dependencies when deploying selected changes. For example, if changes to an app are deployed and this app uses a new object class, the new object class will also be deployed.

The targeted deploy dialog is shown in the image below.

  1. Select which environment to deploy changes to.

  2. Choose whether to deploy all or selected changes from the current environment.

  3. Select which deployable units to deploy. Only units with deployable changes will appear in this list. This list is only visible if Selected changes from Develop is selected.

  4. Information about additional dependencies that will be deployed based on the selected changes.

  5. Click to show a detailed changelog of the selected changes.

Only entities affected by the deploy will hot reload when deploying selected changes. For example, if there are two apps in the solution and changes are only deployed to one, users of the other app will not be affected.

Deploy changelog

If you have undeployed changes in an environment you can view a list of what has changed. Click Change Details to see an overview of:

  • New apps and services

  • New and changed actions, data sources and views by app/service

  • New and changed themes and schedules

  • New and changed enums and object classes

  • Number of deleted apps and services

  • Number of deleted actions, data sources, and views

  • Number of deleted themes and schedules

  • Number of deleted enums and object classes

Appfarm Upgrade

Appfarm Create is frequently upgraded with new releases with both major and minor updates.

Appfarm is responsible for thorough testing of new versions before Appfarm Create is upgraded, but when such upgrades occur the next deployment for all Solutions will be affected.

In the example above, Appfarm Create has been upgraded to Appfarm Version 22-4-33. When Appfarm Create has been upgraded, so has your Develop environment (the client). The Test and Production environments, however, are still on version 22-4-32. The next deployment from Dev to Test will automatically upgrade Test environment to 22-4-33 as well.

Appfarm Upgrades are mandatory and cannot be removed from the Deploy. The reason is that they may contain important bug fixes, or new Appfarm features that require new Appfarm code.

Note that such upgrades of the Test or Production environment are only experienced as an information dialog followed by a refresh for the end user. But we recommend to schedule such deploys to midnight.

Snapshots

A snapshot is a copy of your solution model at a point in time. Your solution model contains the definition of your global data model, apps, services, and other solution-specific metadata generated from Appfarm Create.

Important

A snapshot does not contain any data from the database, such as objects you create and persist via data sources. It contains only the definition of your solution in Appfarm Create.

You can take a snapshot of model currently in Development at any time by clicking + next to Snapshots. Snapshots should be used as a regular part of your development process to protect against unintended changes and avoid data loss. It is often a good idea to take a snapshot before beginning on large scale or destructive changes.

To rollback your model to a previous snapshot, open the three-dot menu for the snapshot you wish to use and select Apply Snapshot to Develop.

Rollback to a snapshot

Rollback to a snapshot means to restore the solution (Apps, Service, Global Data Model) in Develop back to a previous state. This may be used for disaster recovery if you delete or break a part of your application, or to perform a controlled rollback if you have been experimenting with a feature and would like to roll everything back. Note that only the solution (everything created in Appfarm Create) will be rolled back - not the application data.

You may rollback to both manual and automatic snapshots.

Rollback to a manual snapshot:

Rollback to an automatic snapshot:

Combining rollback to snapshot with the Copy to clipboard feature will also allow you to rollback a view etc. to a previous state:

  1. Take a new manual snapshot (give it a proper name)

  2. Rollback to a previous snapshot. Refresh Appfarm Create.

  3. Locate the View, right-click and Copy to clipboard

  4. Rollback to the manual snapshot created in 1). Refresh Appfarm Create.

  5. Paste the View into your App.

Rollback a deploy

As you deploy across environments, a deploy history is generated. This provides a record of who made the deploy, the solution model version deployed, and when the deploy occurred. If you run into issues on a new deploy, you can easily rollback to a previous deploy listed in the history. To do so, open the three-dot menu for the deploy you wish to rollback to and select Rollback to this version.

Users exist across all environments. For example, a user created in Production can be deleted in Test. See for more details.

Appfarm supports two type of deploys, and .

This alert will appear if the deploy will result in an upgrade of the . This process takes just a few minutes and ensures the latest features and bug fixes are applied in the environment.

Click to open the to get a comprehensive overview of the changes to be deployed.

Automatic snapshots is enabled in most Solutions. These will be taken roughly every 5-20 minutes when there is activity and changes made in the solution. A systematic clean-up is performed in order to spread out the snapshots so that there is more time between the stored snapshots the further back in time you go. If you do not have Automatic snapshots enabled, please contact .

Users
Appfarm Client
support@appfarm.io
Solution deploy
Targeted deploy
deploy changelog
Appfarm Client
Snapshots
rollbacks
The Deploy view in Appfarm Create
The blue button is active when there are changes to be deployed
The solution deploy dialog
The targeted deploy dialog
A screenshot of the the Deploy view in Appfarm Create