OpenRport Docs
GITHUB
  • OpenRPort Knowledge Base
  • 👀WHAT IS RPORT
    • Features and benefits of RPort
      • Full feature list
    • Screenshots
  • 🚀GETTING STARTED
    • Install the RPort Server
      • Install on-premises
      • Install RPort on any virgin cloud VM
      • Enable two factor authentication
        • Use push on mobile for 2FA
        • Use TOTP
    • Connecting Clients
    • Using the remote access
      • Creating tunnels
        • VNC via browser
      • RDP via Browser
      • Open SSH from the browser
      • Scp,sftp through a tunnel
    • Renaming and tagging of clients
    • Organize clients with groups
    • Activate the vault
    • Manage users and permissions
  • 🗣️NEED HELP?
    • Troubleshoot common problems
      • Restart rport through a tunnel
      • Attributes file path not set
      • Recover lost passwords
      • Client is not connecting
      • Id is already in use
  • 🔦DIGGING DEEPER
    • Using the API
      • Create client credentials
    • RPort Technology Explained
    • Commands and Scripts
      • Executing commands
      • Executing scripts
      • Tacoscript
    • The scheduler
    • File copy and reception
    • Client Configuration Options
      • Supervision of OS updates
      • Script and command execution
    • Advanced client management
      • Install the RPort client manually
      • Uninstall the RPort client
      • Run with SELinux
    • Server Maintenance
      • Monitoring of RPortd
      • Updating RPort
      • Backing up the rport server
      • Renewing certificates
    • FAQ
      • How to use Cloudflare
Powered by GitBook
On this page
  • At a glance
  • Install Tacoscript
  1. DIGGING DEEPER
  2. Commands and Scripts

Tacoscript

RPort provides its own scripting language to make complex tasks easy.

PreviousExecuting scriptsNextThe scheduler

Last updated 1 year ago

At a glance

Tacoscript is a declarative scripting language for the easy automation of tasks. It uses human-readable YAML as input files. The interpreter consists of a single static binary available for almost any operating system. .

Install Tacoscript

Only for Rport versions before 0.5.0 tacoscript is not installed by default. You must install it manually. But you can use the RPort script execution to perform the installation from the RPort web interface.

$dest = "C:\Program Files\tacoscript"
if(Test-Path -Path $dest) {
    Write-Host "Tacoscript already installed to $($dest)"
    exit 0
}
$Temp = [System.Environment]::GetEnvironmentVariable('TEMP','Machine')
Set-Location $Temp
$url = "https://download.rport.io/tacoscript/stable/?arch=Windows_x86_64"
$file = "tacoscript.zip"
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Invoke-WebRequest -Uri $url -OutFile $file -UseBasicParsing
Write-Host "Tacoscript dowloaded to $($Temp)\$($file)"
New-Item -ItemType Directory -Force -Path "$($dest)\bin"|Out-Null
Expand-Archive -Path $file -DestinationPath $dest -force
mv "$($dest)\tacoscript.exe" "$($dest)\bin"
Write-Host "Tacoscript installed to $($dest)"
$ENV:PATH="$ENV:PATH;$($dest)\bin"

[Environment]::SetEnvironmentVariable(
        "Path",
        [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + ";$($dest)\bin",
        [EnvironmentVariableTarget]::Machine
)
& tacoscript --version
rm $file -force
#!/bin/sh
#
# Install Tacoscript on Linux
#
set -e
if [ -e /usr/local/bin/tacoscript ];then
   echo "Tacoscript already installed"
   exit 0
fi
cd /tmp
test -e tacoscript.tar.gz&&rm -f tacoscript.tar.gz
curl -LJs "https://download.openrport.io/tacoscript/unstable/?arch=Linux_$(uname -m)" -o tacoscript.tar.gz
tar xvzf tacoscript.tar.gz -C /usr/local/bin/ tacoscript
rm -f tacoscript.tar.gz
tacoscript --version

🔦
Read more