1. Registry
  2. Packages
  3. Files.com
  4. Installation & Configuration
Viewing docs for Files.com v0.1.1
published on Thursday, Aug 20, 2026 by jschady

Files.com: Installation & Configuration

filescom logo
Viewing docs for Files.com v0.1.1
published on Thursday, Aug 20, 2026 by jschady

    Packages

    The Files.com provider ships as one package per language.

    LanguagePackage
    JavaScript and TypeScriptpulumi-filescom
    Pythonpulumi-filescom
    Gogithub.com/jschady/pulumi-filescom/sdk/go/filescom
    .NETJschady.Filescom

    Installation

    Run the command for the language your program uses.

    Node.js

    npm install pulumi-filescom
    

    Python

    pip install pulumi-filescom
    

    Go

    go get github.com/jschady/pulumi-filescom/sdk/go/filescom
    

    .NET

    dotnet add package Jschady.Filescom
    

    API key

    The provider authenticates with one API key. Create the key in the Files.com web application, under Settings, then API Keys.

    Warning: If your program source holds the API key, everyone who reads it can read your account. Keep the key in the environment or in the encrypted stack configuration.

    Set the key in the environment:

    export FILES_API_KEY=your-api-key
    

    Or set it in the stack configuration, where Pulumi encrypts it:

    pulumi config set --secret filescom:apiKey your-api-key
    

    The provider reads the environment variable when the stack configuration carries no apiKey.

    Provider configuration

    PropertyEnvironment variableWhat it is
    apiKeyFILES_API_KEYThe API key the provider authenticates with.
    endpointOverridenoneThe endpoint to call. Set it when your site disables global acceleration, or to reach a mock server.
    environmentnoneFiles.com documents no text for this property.
    featureFlagsnoneFiles.com documents no text for this property.

    Explicit provider

    The program below builds one provider from the stack configuration and creates a group with it. Use this shape when one stack must reach two Files.com accounts.

    import * as pulumi from "@pulumi/pulumi";
    import * as filescom from "pulumi-filescom";
    
    const config = new pulumi.Config();
    
    const files = new filescom.Provider("files", {
        apiKey: config.requireSecret("filesApiKey"),
    });
    
    const engineers = new filescom.Group("engineers", {
        name: "engineers",
    }, { provider: files });
    
    import pulumi
    import pulumi_filescom as filescom
    
    config = pulumi.Config()
    
    files = filescom.Provider("files", api_key=config.require_secret("filesApiKey"))
    
    engineers = filescom.Group("engineers",
        name="engineers",
        opts=pulumi.ResourceOptions(provider=files))
    
    using Pulumi;
    using Filescom = Jschady.Filescom;
    
    return await Deployment.RunAsync(() =>
    {
        var config = new Config();
    
        var files = new Filescom.Provider("files", new()
        {
            ApiKey = config.RequireSecret("filesApiKey"),
        });
    
        var engineers = new Filescom.Group("engineers", new()
        {
            Name = "engineers",
        }, new CustomResourceOptions { Provider = files });
    });
    
    package main
    
    import (
    	"github.com/jschady/pulumi-filescom/sdk/go/filescom"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		files, err := filescom.NewProvider(ctx, "files", &filescom.ProviderArgs{
    			ApiKey: config.RequireSecret(ctx, "filesApiKey"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = filescom.NewGroup(ctx, "engineers", &filescom.GroupArgs{
    			Name: pulumi.String("engineers"),
    		}, pulumi.Provider(files))
    		return err
    	})
    }
    
    filescom logo
    Viewing docs for Files.com v0.1.1
    published on Thursday, Aug 20, 2026 by jschady

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial